ThinkPHP如何实现数据库操作审计日志_模型行为扩展技巧

酷萱姑娘_9740

酷萱姑娘_9740

2026-04-15

414人浏览

原创

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

thinkphp如何实现数据库操作审计日志_模型行为扩展技巧

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 等自动行为。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
  • 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免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php thinkphp

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

5083

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

1031

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1329

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

7161

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3783

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

7140

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

10021

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1370

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1192

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习