Laravel Authentication Log requires Laravel 5.5 or higher, and PHP 7.0+.
You may use Composer to install Laravel Authentication Log into your Laravel project:
composer require yadahan/laravel-authentication-log
After installing the Laravel Authentication Log, publish its config, migration and view, using the vendor:publish
Artisan command:
php artisan vendor:publish --provider="Yadahan\AuthenticationLog\AuthenticationLogServiceProvider"
Next, you need to migrate your database. The Laravel Authentication Log migration will create the table your application needs to store authentication logs:
php artisan migrate
Finally, add the AuthenticationLogable
and Notifiable
traits to your authenticatable model (by default, App\User
model). These traits provides various methods to allow you to get common authentication log data, such as last login time, last login IP address, and set the channels to notify the user when login from a new device:
use Illuminate\Notifications\Notifiable;
use Yadahan\AuthenticationLog\AuthenticationLogable;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable
{
use Notifiable, AuthenticationLogable;
}
Get all authentication logs for the user:
User::find(1)->authentications;
Get the user last login info:
User::find(1)->lastLoginAt();
User::find(1)->lastLoginIp();
Get the user previous login time (ignoring the current login):
auth()->user()->previousLoginAt();
Notifications may be sent on the mail
, nexmo
, and slack
channels. By default notify via email.
You may define notifyAuthenticationLogVia
method to determine which channels the notification should be delivered on:
/**
* The Authentication Log notifications delivery channels.
*
* @return array
*/
public function notifyAuthenticationLogVia()
{
return ['nexmo', 'mail', 'slack'];
}
Of course you can disable notification by set the notify
option in your config/authentication-log.php
configuration file to false
:
'notify' => env('AUTHENTICATION_LOG_NOTIFY', false),
You may clear the old authentication log records using the authentication-log:clear
Artisan command:
php artisan authentication-log:clear
Records that is older than the number of days specified in the older
option in your config/authentication-log.php
will be deleted:
'older' => 365,
Thank you for considering contributing to the Laravel Authentication Log.
Laravel Authentication Log is open-sourced software licensed under the MIT license.