sudo-su - GitLite

KO | EN

gitlite — search

#python #typescript #android #machine-learning #linux #docker #awesome #cli #awesome-list #vue #security #mcp #openai #open-source

sudo-su

(★ 543)

Laravel package to easily login as other users during development.

File Explorer

Download Latest Version (.zip)

- sudosu.php
- - user-selector.blade.php
- - SudoSuController.php
- RouteServiceProvider.php
- ServiceProvider.php
- SudoSu.php
.gitignore
composer.json
LICENSE
mix-manifest.json
package.json
README.md
webpack.mix.js
yarn.lock

# Installation Guide

1. Get the code

git clone https://github.com/viacreative/sudo-su

Downloads the entire project code from GitHub to your computer.

cd sudo-su

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

3. PHP (Composer)

Easy

Prerequisites

Git Needed to download the project code from GitHub.
PHP A PHP runtime is required.
Composer The package manager used to install PHP libraries.

$ composer require viacreative/sudo-su

Type this command into your terminal and run it.

✅ Run it with a built-in server like php -S localhost:8000, then open http://localhost:8000 in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Demonstration](https://d78vgg4relhwk.cloudfront.net/sudo-su.gif)

![Licence: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)

A Laravel 5.4 utility package to enable developers to log in as other users during development.

## Installation
To install the package, simply follow the steps below.

Install the package using Composer:

```
$ composer require viacreative/sudo-su
```

Add the package's service provider to your app in your project's `AppServiceProvider`:

```php
class AppServiceProvider extends ServiceProvider
{
    public function register()
    {
        if (config('app.debug')) {
            $this->app->register('VIACreative\SudoSu\ServiceProvider');
        }
    }
}
```

⚠️  *Warning:* You should not register the provider globally like usual in the `config/app.php` file. View the disclaimer [here](#disclaimer---danger) for more information.

Include the partial in your layout file.

```php
@if (config('app.debug'))
    @include('sudosu::user-selector')
@endif
```

Finally, publish the package's assets (the package won't work without this):

```
$ php artisan vendor:publish
```

## Config
After running `vendor:publish`, a config file called `sudosu.php` should appear in your project. Within here, there are two configuration values:

**sudosu.allowed_tlds `array`**

By default, the package will disable itself on any domains that don't have a TLD of `.dev` or `.local`. This is a security measure to reduce the risk of accidentally enabling the package in production. If you have a different TLD in development, you can edit the config option `sudosu.allowed_tlds`.

**sudosu.user_model `string`**

The path to the application User model. This will be used to retrieve the users displayed in the select dropdown. This must be an Eloquent Model instance. This is set to `App\User` by default.

## Disclaimer - DANGER!
This package can pose a serious security issue if used incorrectly, as anybody will be able to take control of any user's account. Please ensure that the service provider is only registered when the app is in a debug/local environment.

By default, the package will disable itself on any domains that don't have a TLD of `.dev` or `.local`. This is a security measure to reduce the risk of accidentally enabling the package in production. If you have a different TLD in development, you can edit the config option `sudosu.allowed_tlds`.

By using this package, you agree that VIA Creative and the contributors of this package cannot be held responsible for any damages caused by using this package.