laravolt / auth
Laravel auth extended
Installs: 8 444
Dependents: 0
Suggesters: 0
Security: 0
Stars: 12
Watchers: 3
Forks: 4
Open Issues: 5
Requires
- php: >=7.1.3
- anhskohbo/no-captcha: ^3.0.1
- doctrine/dbal: ~2.5
- illuminate/auth: 5.6.*|5.7.*|5.8.*|^6.0
- illuminate/mail: 5.6.*|5.7.*|5.8.*|^6.0
- illuminate/support: 5.6.*|5.7.*|5.8.*|^6.0
- laravolt/password: ^1.6
- laravolt/ui: ~0.5
Requires (Dev)
- mockery/mockery: ^1.0
- orchestra/database: ^3.4|^4.0
- orchestra/testbench-browser-kit: 3.6.*|3.7.*|3.8.*|^4.0
- phpunit/phpunit: ^7.0
Suggests
- adldap2/adldap2-laravel: Required if ldap login enabled
- subfission/cas: Required if cas login enabled
- dev-master / 5.0.x-dev
- v4.x-dev
- 4.10.5
- 4.10.4
- 4.10.3
- 4.10.2
- 4.10.1
- 4.10.0
- 4.9.3
- 4.9.2
- 4.9.1
- 4.9.0
- 4.8.4
- 4.8.3
- 4.8.2
- 4.8.1
- 4.8.0
- 4.7.0
- 4.6.17
- 4.6.16
- 4.6.15
- 4.6.14
- 4.6.13
- 4.6.12
- 4.6.11
- 4.6.10
- 4.6.9
- 4.6.8
- 4.6.7
- 4.6.6
- 4.6.5
- 4.6.4
- 4.6.3
- 4.6.2
- 4.6.1
- 4.6.0
- 4.5.1
- 4.5.0
- 4.4.3
- 4.4.2
- 4.4.1
- 4.4.0
- 4.3.2
- 4.3.1
- 4.3.0
- 4.2.1
- 4.2.0
- 4.1.0
- 4.0.0
- v2.x-dev
- 2.1.4
- 2.1.3
- 2.1.2
- 2.1.1
- 2.1.0
- 2.0
- 1.1
- 1.0.2
- 1.0.1
- 1.0.0
- 0.x-dev
- 0.6.x-dev
- 0.6
- 0.5
- 0.4
- 0.3
- 0.2
- 0.1
- dev-analysis-4xlADG
This package is auto-updated.
Last update: 2020-10-28 05:10:44 UTC
README
Laravel authentication with some additional features:
- Activation
- Enable/disable registration
- Captcha
- Custom email template
- Functionally tested
Installation
- Run
composer require laravolt/auth
- For Laravel 5.4 or below, add
Laravolt\Auth\ServiceProvider::class
as service providers - Optionally, you can run
php artisan vendor:publish --provider="Laravolt\Auth\ServiceProvider" --tag="migrations"
to publish migrations files for further editing
Configuration
<?php return [ // Base layout to extend by every view 'layout' => 'ui::layouts.auth', // Enable captcha (Google reCaptcha) on login form 'captcha' => false, // Column name to be checked for authentication (login) 'identifier' => 'email', // Configuration related to login process 'login' => [ 'implementation' => \Laravolt\Auth\DefaultLogin::class, ], // Configuration related to registration process 'registration' => [ // Enable or disable registration form 'enable' => true, // Default status for newly registered user 'status' => 'ACTIVE', // During the process, data from registration form will be passed to this class. // You may create your own implementation by creating UserRegistrar class. 'implementation' => \Laravolt\Auth\DefaultUserRegistrar::class, ], // Configuration related to registration process 'activation' => [ // If enabled, newly registered user are not allowed to login until they click // activation link that sent to their email. 'enable' => false, // Status for newly registered user, before activation 'status_before' => 'PENDING', // Status for newly registered user, after successfully activate their account 'status_after' => 'ACTIVE', ], // Routes configuration 'router' => [ 'middleware' => ['web'], 'prefix' => 'auth', ], // Redirect configuration 'redirect' => [ // Where to redirect after successfully login 'after_login' => '/', // Where to redirect after successfully register 'after_register' => '/', // Where to redirect after successfully reset password 'after_reset_password' => '/', ], // Whether to auto load migrations or not. // If set to false, then you must publish the migration files first before running the migrate command 'migrations' => false, ];
Captcha
If you enable captcha (by setting 'captcha' => true
in config file), please add following entries to .env
:
NOCAPTCHA_SECRET=YOUR_RECAPTCHA_SECRET
NOCAPTCHA_SITEKEY=YOUR_RECAPTCHA_SITEKEY
You can obtain them from www.google.com/recaptcha/admin.
Custom Login Form
Modify Form (View File)
Run php artisan vendor:publish --provider="Laravolt\Auth\ServiceProvider"
.
You can modify the view located in resources/views/vendor/auth/login.blade.php
.
Modify Logic
Create new class to handle user login that implements Laravolt\Auth\Contracts\Login
contract.
You must implement two method related to registration:
rules(Request $request)
to get validation rules.credentials(Request $request)
to check valid credentials. optionally:authenticated(Request $request, $user)
to handle after login, it should be returned\Illuminate\Http\Response
ornull
failed(Request $request)
to handle custom failed response
Custom Registration Form
Sometimes you need to modify registration form, e.g. add more fields, change logic, or add some validation. There are several way you can accomplish those.
Modify Form (View File)
Run php artisan vendor:publish --provider="Laravolt\Auth\ServiceProvider"
.
You can modify the view located in resources/views/vendor/auth/register.blade.php
.
Modify Logic
Create new class to handle user registration that implements Laravolt\Auth\Contracts\UserRegistrar
contract.
You must implement two method related to registration:
validate($data)
to handle validation logic.register($data)
to handle user creation logic. optionally:registered(Request $request, $user)
to handle after registration is completed, it should be returned\Illuminate\Http\Response
ornull
<?php namespace App\Registration; use Illuminate\Support\Facades\Validator; use Laravolt\Auth\Contracts\UserRegistrar; class CustomUserRegistrar implements UserRegistrar { /** * Validate data. * * @param array $data */ public function validate(array $data) { // Modify default behaviour, or completely change it return Validator::make( $data, [ 'name' => 'required|max:255', 'email' => 'required|email|max:255|unique:users', 'password' => 'required|min:6', ] ); } /** * Create model. * * @param $ * */ public function register(array $data) { // create Authenticatable model. $user = User::create($data); // return Authenticatable model. return $user; } }
Modify Activation Logic
add Laravolt\Auth\Contracts\ShouldActivate
implementation to your registration.implementation
class by add these function to your registrar class.
notify(Model $user, $token)
activate($token)
... class CustomUserRegistrar implements UserRegistrar, ShouldActivate { ... /** * Notify if user to activate the user with the token provided. * * @param \Illuminate\Database\Eloquent\Model|Authenticatable $user * @param string $token * @return void */ public function notify(Model $user, $token) { // } /** * Activation method by the token provided. * * @param string $token * @return \Illuminate\Http\Response */ public function activate($token) { $token = \DB::table('users_activation')->whereToken($token)->first(); if (! $token) { abort(404); } \User::where('id', $token->user_id)->update(['status' => config('laravolt.auth.activation.status_after')]); \DB::table('users_activation')->where('user_id', $token->user_id)->delete(); return redirect()->route('auth::login')->withSuccess(trans('auth::auth.activation_success')); } }
After that, you must update auth config (located in config/laravolt/auth.php
, if not, just run php artisan vendor:publish
).
... 'registration' => [ // During the process, data from registration form will be passed to this class. // You may create your own implementation by creating UserRegistrar class. 'implementation' => \App\Registration\CustomUserRegistrar::class, ], ...
LDAP
Environment Variables
LDAP_HOSTS=ldap.forumsys.com
LDAP_BASE_DN='dc=example,dc=com'
LDAP_PORT=389
LDAP_USERNAME='cn=read-only-admin,dc=example,dc=com'
LDAP_PASSWORD='password'
LDAP_USE_SSL=false
LDAP_USE_TLS=false