Laravel Activity Log操作日志扩展包

简介

Laravel Action Logs操作日志记录Laravel Activity Log

很多数据管理员都想记录他们用户的所有活跃记录。这个包可以很方便的记录你的用户何时何地的创建、更新实体的记录。外加，现在这个包还可以记录多个版本的实体间数据的变更。

优势

1. 简单的实体实现
2. 记录所有创建、更新实体的用户和次数
3. 支持记录自定义信息（登录、登出等）

福利彩蛋：没有好玩的 API 接口？上百款免费接口等你来，免费 API，免费 API 大全

安装

安装组件

composer require spatie/laravel-activitylog

发布配置文件

php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="config"

数据迁移文件

php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="migrations"

数据迁移

php artisan migrate

.env配置数据库连接

新版本添加了日志数据库连接配置，如有需要可以自定义连接，否则会适用系统默认的数据库连接

ACTIVITY_LOGGER_DB_CONNECTION=connection

用法

基础用法

扩展基本使用,直接在想记录日志的地方条用改方法，比如登录成功或失败的时候需要记录下登录日志

activity()->log('Look mum, I logged something');

可以使用performedOn方法设置日志是在哪个对象上执行的操作（例如Users Model）

activity()->performedOn(new User())->log('edited');

你可以通过使用causedBy来设置谁或者什么原因触发了这个活动:这里的model和conentModel没有必然的联系，$model可以是任意一个model对象，也可以是用户主键ID；只能说是某个用户或某个业务触发了$someContentModel对象的操作

如果这里不指定causedBy 那么日志将会自动默认值User model当前登录的用户

如果不想关联日志触发者的话，可以使用causedByAnonymous()忽略记录

activity()->causedBy($model)->performedOn($someContentModel)->log('edited');

您可以使用withProperties主动向活动添加任何想要的属性：记录在properties

activity()->causedBy($model)->performedOn($someContentModel)->withProperties(['key' => 'value'])->log('edited');

日志创建时间设置：createdAt(now()->subDays(10))日志时间设置为10天前

activity()->causedBy($model)->performedOn($someContentModel)->withProperties(['key' => 'value'])->createdAt(now()->subDays(10))->log('edited');

可以使用tap()方法在保存活动之前填充属性并添加自定义字段:如在日志基础上添加客户端Ip字段，首先数据库添加字段，然后通过tap方式设置ip

activity()->causedBy($model)->performedOn($someContentModel)->withProperties(['key' => 'value'])->createdAt(now()->subDays(10))->tap(function(Activity $activity) {$activity->ip = request()->ip();})->log('edited');

日志清理

日志清理命令:需要config配置中设置delete_records_older_than_days保留日志天数

php artisan activitylog:clean

也可以通过任务定时清理

//app/Console/Kernel.phpprotected function schedule(Schedule $schedule)
{$schedule->command('activitylog:clean')->daily();
}

清理特定名称的日志

php artisan activitylog:clean my_log_channel

命令执行的时候可以添加时间参数：

php artisan activitylog:clean --days=7

福利彩蛋：没有好玩的 API 接口？上百款免费接口等你来，免费 API，免费 API 大全