Spatie Laravel Activitylog 包：用户行为日志记录解决方案详解-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00418/article/details/148505238

Spatie Laravel Activitylog 包：用户行为日志记录解决方案详解

laravel-activitylog Log activity inside your Laravel app 项目地址: https://gitcode.com/gh_mirrors/la/laravel-activitylog

什么是 Laravel Activitylog

Spatie 开发的 Laravel Activitylog 是一个专门用于记录用户操作行为的扩展包，它为 Laravel 应用提供了简单易用的活动日志记录功能。通过这个包，开发者可以轻松追踪用户在系统中的各种操作，包括但不限于模型创建、更新、删除等事件。

核心功能特性

基础日志记录：支持记录任意自定义活动日志
模型事件自动记录：自动追踪 Eloquent 模型的变化
关联记录：将活动与特定模型和执行者关联
属性存储：支持存储额外的自定义属性
变更追踪：自动记录模型修改前后的差异

快速入门示例

基本日志记录

// 记录一条简单的活动日志
activity()->log('用户执行了某项操作');

高级日志记录

activity()
   ->performedOn($article)  // 关联到文章模型
   ->causedBy($user)        // 关联到执行用户
   ->withProperties([       // 添加自定义属性
       'ip_address' => request()->ip(),
       'user_agent' => request()->userAgent()
   ])
   ->log('用户更新了文章内容');

日志查询与使用

所有活动日志都存储在 activity_log 表中，可以通过 Activity 模型进行查询：

// 获取所有活动记录
$activities = Spatie\Activitylog\Models\Activity::all();

// 获取最新的一条记录
$lastActivity = Activity::latest()->first();

// 访问记录属性
$subject = $lastActivity->subject;      // 获取关联的模型实例
$causer = $lastActivity->causer;        // 获取执行者模型实例
$description = $lastActivity->description; // 获取活动描述
$customValue = $lastActivity->getExtraProperty('ip_address'); // 获取自定义属性

自动记录模型变更

Activitylog 可以自动记录 Eloquent 模型的变更：

$product = Product::find(1);
$product->price = 99.99;
$product->save();

// 自动记录变更
$activity = Activity::latest()->first();

// 获取变更详情
$changes = $activity->changes;
/*
返回结果示例:
[
   'old' => [
        'price' => 89.99,
        'name' => '原始产品名称',
    ],
    'attributes' => [
        'price' => 99.99,
        'name' => '原始产品名称',
    ],
]
*/