Spatie Laravel Activitylog 安装与配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00246/article/details/148505235

Spatie Laravel Activitylog 安装与配置指南

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

概述

Spatie Laravel Activitylog 是一个功能强大的活动日志记录包，可以帮助开发者轻松跟踪和记录应用程序中的各种操作。本文将详细介绍如何安装和配置这个包，以便您能够快速开始使用它来记录应用中的活动。

安装步骤

1. 通过Composer安装包

首先，使用Composer将包添加到您的Laravel项目中：

composer require spatie/laravel-activitylog

安装完成后，包会自动注册其服务提供者，无需手动操作。

2. 数据库连接配置（可选）

如果您希望将活动日志存储在特定的数据库连接中，可以在.env文件中设置以下环境变量：

ACTIVITY_LOGGER_DB_CONNECTION=your_connection_name

3. 清除配置缓存

为确保所有配置正确加载，建议运行以下命令清除配置缓存：

php artisan config:clear

数据库迁移

1. 发布迁移文件

Activitylog需要一个数据库表来存储活动记录。发布迁移文件：

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

2. 运行迁移

发布迁移文件后，执行迁移命令创建activity_log表：

php artisan migrate

配置选项

1. 发布配置文件（可选）

如果需要自定义包的默认行为，可以发布配置文件：

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

2. 配置文件详解

发布的配置文件包含以下重要选项：

return [
    // 是否启用活动日志记录
    'enabled' => env('ACTIVITY_LOGGER_ENABLED', true),

    // 自动清理超过指定天数的记录
    'delete_records_older_than_days' => 365,

    // 默认日志名称
    'default_log_name' => 'default',

    // 用于获取用户模型的认证驱动
    'default_auth_driver' => null,

    // 是否返回软删除的模型
    'subject_returns_soft_deleted_models' => false,

    // 活动模型类
    'activity_model' => \Spatie\Activitylog\Models\Activity::class,

    // 活动日志表名
    'table_name' => env('ACTIVITY_LOGGER_TABLE_NAME', 'activity_log'),

    // 数据库连接
    'database_connection' => env('ACTIVITY_LOGGER_DB_CONNECTION'),
];