/multi-auth

Laravel Multi-Authentication Package

Primary LanguagePHPMIT LicenseMIT

Laravel Multi-Authentication Package

Total Downloads Latest Stable Version License Build Status

This package simplifies multi authentication for your Laravel project, it will scaffold all the files you need for creating a custom guard as well as setting it up ready for use.

Version Compatibility

Laravel Package Installation
5.3 2.x composer require bmatovu/multi-auth 2.*
5.4 3.x composer require bmatovu/multi-auth 3.*
5.5 4.x composer require bmatovu/multi-auth 4.*
5.6 5.x composer require bmatovu/multi-auth 5.*
5.7 6.x composer require bmatovu/multi-auth 6.*
5.8 7.x composer require bmatovu/multi-auth 7.*
6.0 8.x composer require bmatovu/multi-auth ^8.0
7.0 9.x composer require bmatovu/multi-auth ^9.0
8.0 master composer require bmatovu/multi-auth

The service provider will be auto-discovered for Laravel 5.5 and above. Alternatively; you may manually register the service provider in your configuration config/app.php file:

'providers' => array(
    // ...
    Bmatovu\MultiAuth\MultiAuthServiceProvider::class,
),

Bootstrapping

php artisan multi-auth:install {guard}

Default guard is named: admin be sure to use a guard name that suits your needs. This command will scaffold configurations, controllers, middleware, migrations, models, factories, notifications, routes, and views; to get you started.

See a full list of files created, or affected at files.md

Run Database Migrations

php artisan migrate

Getting started

Compile CSS and JS (Optional)

The Bootstrap and Vue scaffolding provided by Laravel as of version 6.0 is now located in the laravel/ui Composer package.

In a surprise twist of events; Laravel will be dropping support for laravel/ui in later versions in favour of laravel/jetstream. This package is not supporting the latter but we intend to catch up ASAP.

Note: This should be done only for fresh installations.

composer require laravel/ui

php artisan ui bootstrap

npm install && npm run dev

Serve application

http://127.0.0.1:8000/{guard}

Extras

Check guards

$ php artisan tinker
...
>>> config('auth.guards');

Access guard instance:

Specify the guard instance you would like to use, eg using admin guard...

Auth::guard('admin')->user();

Check routes:

To find out which routes have been created for your guard

php artisan route:list

Email verification:

You may require users to verify their email addresses before using the application. Read the wiki on how to enable this.

Reporting bugs

If you've stumbled across a bug, please help us by leaving as much information about the bug as possible, e.g.

  • Steps to reproduce
  • Expected result
  • Actual result

This will help us to fix the bug as quickly as possible, and if you wish to fix it yourself feel free to fork the package and submit a pull request!