Spatie Laravel Activitylog 日志清理最佳实践

Spatie Laravel Activitylog 日志清理最佳实践

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

为什么需要清理活动日志

在长期使用 Spatie Laravel Activitylog 包记录系统活动后，数据库中的活动日志表会不断增长。过多的历史日志不仅会占用大量存储空间，还可能影响查询性能。因此，定期清理过期日志是系统维护的重要环节。

基础清理方法

该包提供了一个便捷的 Artisan 命令来清理日志：

php artisan activitylog:clean

这个命令会根据配置文件中 delete_records_older_than_days 设置的天数阈值，删除所有早于该天数的活动记录。

自动化清理方案

为了确保日志清理工作能够定期执行，我们可以将其添加到 Laravel 的任务调度中：

// app/Console/Kernel.php

protected function schedule(Schedule $schedule)
{
   $schedule->command('activitylog:clean')->daily();
}

在生产环境中运行时，建议添加 --force 参数以避免交互式确认：

php artisan activitylog:clean --force

高级清理选项

按日志名称清理

如果系统使用了多个日志通道，可以指定只清理特定名称的日志：

php artisan activitylog:clean my_log_channel

临时调整保留天数

有时我们可能需要临时调整清理的保留天数，而不修改配置文件：

php artisan activitylog:clean --days=7

这个命令会覆盖配置文件中的设置，仅针对本次执行有效。

MySQL 数据库优化技巧

在执行大规模日志清理后，MySQL 表可能仍然占用较多空间，这是因为数据库不会自动回收已删除记录占用的空间。我们可以使用以下命令优化表：

OPTIMIZE TABLE activity_log;

或者：

ANALYZE TABLE activity_log;

重要提示：这些操作会锁定表的读写，只能在维护时段执行，避免影响线上服务。

最佳实践建议

1. 合理设置保留天数：根据业务需求和法律合规要求设置适当的日志保留期限
2. 低峰期执行：将清理任务安排在系统负载较低的时段
3. 监控日志增长：定期检查日志表大小，调整清理策略
4. 备份重要日志：在清理前确保关键业务日志已备份
5. 测试环境验证：先在测试环境验证清理策略，确保不会误删重要数据

通过合理配置和定期维护，可以确保活动日志系统既满足业务需求，又不会对系统性能造成负面影响。

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