README

Laravel Auth Log 是一个自动记录用户所有登录的包。它还可以在从未知设备成功登录时发送通知。

此包是 https://github.com/yadahan/laravel-authentication-log 的修改和扩展版本。

安装

Laravel Auth Log 需要 Laravel 5.8 或更高版本，以及 PHP 7.2+。

您可以使用 Composer 将 Laravel Auth Log 安装到您的 Laravel 项目中

composer require adaa/laravel-auth-log

配置

安装 Laravel Auth Log 后，使用 vendor:publish Artisan 命令发布其配置、迁移和视图

php artisan vendor:publish --provider="Adaa\AuthLog\AuthLogServiceProvider"

接下来，您需要迁移您的数据库。Laravel Auth Log 迁移将创建您的应用程序存储身份验证日志所需的数据表

php artisan migrate

最后，将 AuthLogable 和 Notifiable 特性添加到您的认证模型（默认为 App\User 模型）。这些特性提供了各种方法，允许您获取常见的身份验证日志数据，例如最后登录时间、最后登录 IP 地址，并设置当从新设备登录时通知用户的消息通道

use Adaa\AuthLog\AuthLogable;
use Illuminate\Notifications\Notifiable;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use Notifiable, AuthLogable;
}

基本用法

获取用户的全部身份验证日志

User::find(1)->authentications;

获取用户最后登录信息

User::find(1)->lastLoginAt();

User::find(1)->lastLoginIp();

获取用户之前的登录时间和 IP 地址（忽略当前登录）

auth()->user()->previousLoginAt();

auth()->user()->previousLoginIp();

通知新设备登录

通知可能通过 mail、nexmo 和 slack 通道发送。默认通过电子邮件通知。

您可以通过定义 notifyAuthenticationLogVia 方法来决定通知通过哪些通道发送

/**
 * The Auth Log notifications delivery channels.
 *
 * @return array
 */
public function notifyAuthenticationLogVia()
{
    return ['nexmo', 'mail', 'slack'];
}

当然，您可以通过将您的 config/auth-log.php 配置文件中的 notify 选项设置为 false 来禁用通知

'notify' => env('AUTH_LOG_NOTIFY', false),

清除旧日志

您可以使用 auth-log:clear Artisan 命令清除旧的身份验证日志记录

php artisan auth-log:clear

将删除比您的 config/auth-log.php 中的 older 选项指定的天数更早的记录

'older' => 365,

贡献

感谢您考虑为 Laravel Auth Log 贡献。

许可证

Laravel Auth Log 是开源软件，许可协议为 MIT 许可证。