应使用模型事件(如before_write、after_write)而非重写save()/delete(),因其覆盖所有写入路径;审计日志需独立建模、禁用autoWrite、显式赋值时间与操作人,并通过exists()和delete_time判断操作类型,且日志写入须fail-safe。

ThinkPHP 模型 save() / delete() 前怎么自动记录操作日志
直接在模型里重写 save() 和 delete() 方法不保险——TP 的批量更新(update())、软删除、关联保存等场景会绕过它们。真正稳定的做法是用「模型事件」,而不是手动拦截方法调用。
ThinkPHP 6+ 支持模型生命周期事件,比如 before_write、after_delete,它们在底层 SQL 执行前/后触发,覆盖所有写入路径(包括 save()、update()、destroy()、关联保存等)。
-
必须监听
before_write:它在数据写入前触发,能拿到完整待写入数据和操作类型(insert/update),适合记录“谁要改什么” -
搭配
after_write更稳妥:如果需要记录 SQL 影响行数或是否成功,这个事件更合适;但注意它不区分 insert/update,需自己判断 -
别用
before_update单独监听:TP 不保证该事件一定触发(比如用Db::table()->where()->update()就不会走模型事件)
审计日志字段设计要避开 TP 自动填充的坑
常见错误是把 operator_id 或 ip 字段也设成模型的 autoWrite 字段,结果日志表自己也被自动填充逻辑干扰,甚至死循环。
审计日志应独立建模(如 AuditLog),且它的字段必须显式赋值,不能依赖模型的 createTime、updateTime 等自动行为。
-
AuditLog模型里禁用autoWrite:在protected $autoWrite = false;或直接不定义 - 时间字段用
date('Y-m-d H:i:s')显式传入,避免和主模型的datetime类型自动转换冲突 - 操作人字段别硬写
session('user.id'):TP 的模型事件可能在命令行或队列中触发,session 不可用;改用think\facade\Request::instance()->ip()+ 当前用户 ID(从请求上下文或 Token 解析)
如何区分 insert / update / delete 操作类型
TP 的模型事件本身不直接暴露操作类型,得靠判断数据状态。最可靠的方式是在 before_write 里检查主键是否存在、是否为新记录。
// 在模型中注册事件
protected $eventAfterWrite = ['before_write' => 'onBeforeWrite'];
protected function onBeforeWrite()
{
$data = $this->getData();
$pk = $this->getPk();
if (is_null($data[$pk] ?? null)) {
// 新增:主键为空或未设置
$action = 'insert';
} elseif ($this->exists()) {
// 更新:已存在数据库记录
$action = 'update';
} else {
// 特殊情况:主键有值但 not exists() → 可能是强制 insert 或脏数据
$action = 'insert';
}
// 记录到 AuditLog
AuditLog::create([
'table_name' => $this->getName(),
'action' => $action,
'data' => json_encode($data, JSON_UNESCAPED_UNICODE),
'ip' => request()->ip(),
'created_at' => date('Y-m-d H:i:s'),
]);
}
-
$this->exists()是关键:它查内存标记,不是发 SQL,性能好且准确 - 不要用
isset($data[$pk])判断新增——有些业务主键是 UUID 或非自增,也可能显式传了空字符串 - 软删除的
delete()触发的是before_write(因为本质是 update),需额外检查$this->getOrigin('delete_time') === null来识别真删除
审计日志写入失败不能影响主业务
日志写入失败(比如数据库连不上、磁盘满)导致主流程报错,这是典型的设计失误。审计是旁路行为,必须 fail-safe。
- 所有日志写入逻辑必须包在
try/catch里,捕获Throwable,仅记录错误到本地文件或系统日志(think\facade\Log::error()) - 避免在模型事件里调用耗时操作(如 HTTP 请求、大对象序列化)——
json_encode($this->toArray())比json_encode($this->getData())更安全,前者过滤掉内部属性和关系数据 - 高频写入场景下,考虑异步落库:把日志数据推到 Redis 队列,由单独命令行任务消费,但要注意事件闭包里不能直接 use $this(模型实例可能被销毁)
最常被忽略的是「软删除识别」和「命令行上下文缺失用户信息」——这两个点一旦漏掉,日志就断层或填空,后续根本没法追溯。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











