kbwebs / multiauth
MultiAuth for Laravel 5.1
Installs: 89 273
Dependents: 3
Suggesters: 0
Security: 0
Stars: 139
Watchers: 12
Forks: 37
Open Issues: 19
Requires
- php: >=5.5.9
- illuminate/auth: ~5.1
- illuminate/console: ~5.1
- illuminate/database: ~5.1
- illuminate/filesystem: ~5.1
- illuminate/support: ~5.1
This package is not auto-updated.
Last update: 2022-06-28 21:34:35 UTC
README
Installation
First, pull in the package through Composer.
"require": { "kbwebs/multiauth": "~1.0" }
Now you'll want to update or install via composer.
composer update
Authentication
Open up the config/app.php file and replace the AuthServiceProvider with:
Illuminate\Auth\AuthServiceProvider::class -> Kbwebs\MultiAuth\AuthServiceProvider::class
And open config/auth.php file and remove:
'driver' => 'eloquent' 'model' => App\User::class, 'table' => 'users'
and replace it with this array:
'multi-auth' => [ 'admin' => [ 'driver' => 'eloquent', 'model' => App\Admin::class ], 'user' => [ 'driver' => 'eloquent', 'model' => App\User::class ] ]
If you want to use Database instead of Eloquent you can use it as:
'user' => [ 'driver' => 'database', 'table' => 'users' ]
Password Resets
Open up config/app.php file and replace the PasswordResetServiceProvider with:
Illuminate\Auth\Passwords\PasswordResetServiceProvider::class -> Kbwebs\MultiAuth\PasswordResets\PasswordResetServiceProvider::class
If you want to use the password resets from this Package you will need to change this in each Model there use password resets:
use Illuminate\Auth\Passwords\CanResetPassword; use Illuminate\Contracts\Auth\CanResetPassword as CanResetPasswordContract;
to
use Kbwebs\MultiAuth\PasswordResets\CanResetPassword; use Kbwebs\MultiAuth\PasswordResets\Contracts\CanResetPassword as CanResetPasswordContract;
If you want to change the view for password reset for each auth type you can add this to the multi-auth array in config/auth.php:
'email' => 'emails.users.password'
If you dont add this line, Laravel will automatically use the default path for emails.password like its defined in the password array.
To generate the password resets table you will need to run the following command:
php artisan kbwebs:multi-auth:create-resets-table
Likewise, if you want to clear all password resets, you have to run the following command:
php artisan kbwebs:multi-auth:clear-resets
NOTE It is very important that you replace the default service providers. If you do not wish to use Password resets, then remove the original Password resets server provider as it will cause errors.
Usage
Authentication:
It works just like the original laravel authentication library, the only change is the user() or admin() it will match the auth type, as your defining in the multi-auth array:
Auth::attempt(['email' => $email, 'password' => $password], $remember)
But now it has to be like, with the user() or admin():
Auth::user()->attempt(['email' => $email, 'password' => $password], $remember)
If you want to access the information for the authenticated user, you can do this:
Auth::user()->get();
OR
Auth::user()->get()->email
Password resets:
It works just like the original laravel authentication library, the only change is the user() or admin() it will match the auth type, as your defining in the multi-auth array:
Password::sendResetLink($request->only('email'), function (Message $message) {
$message->subject($this->getEmailSubject());
});
But now it has to be like, with the user() or admin():
Password::user()->sendResetLink($request->only('email'), function (Message $message) {
$message->subject($this->getEmailSubject());
});
Example for a password reset email:
Click here to reset your password: {{ URL::to('password/reset', array($type, $token)) }}.
This generates a URL like the following:
http://example.com/password/reset/user/21eb8ee5fe666r3b8d0521156bbf53266bnca572
Which will match the following route:
Route::get('password/reset/{type}/{token}', 'Controller@method');
Tip:
Remember to update all places where ex: Auth:: is been using, to ex: Auth::user() or what you have defined in config/auth.php