laracomponents/impersonation

Impersonating user for Laravel application.

Impersonation for Laravel

![Build Status][travis-image] ![Quality Score][quality-score-image] ![Total Downloads][downloads-image] , _(*1)

Introduction

Impersonating user for Laravel application., _(*2)

Installation

You can install this package via composer using this command:, _(*3)

composer require laracomponents/impersonation

Next, you must add the Impersonable trait to the user model:, _(*4)

use LaraComponents\Impersonation\Traits\Impersonable;

class User
{
    use Impersonable;
    ...

    /**
     * Optional method
     * Default return the "impersonate_id"
    **/
    public function getImpersonatingKey()
    {
        return 'your session key here';
    }
}

Open App/Http/Kernal.php and add middleware to web middleware group:, _(*5)

    protected $middlewareGroups = [
        'web' => [
            ...
            \LaraComponents\Impersonation\Middleware\CheckForImpersonating::class,
        ],
        ...
    ];

And finally you should add a routes to routes/web.php. Example:, _(*6)

Route::get('users/{id}/impersonate', function ($id) {
    $user = \App\User::findOrFail($id);

    if(! $user->isImpersonating()) {
        $user->impersonate();
    }

    return redirect('/');
});

Route::get('users/unimpersonate', function () {
    $user = \Auth::user();

    if($user->isImpersonating()) {
        $user->unimpersonate();
    }

    return redirect('/');
});

Testing

You can run the tests with:, _(*7)

vendor/bin/phpunit

License

The MIT License (MIT). Please see License File for more information., _(*8)