ThinkPHP需手动集成中间件实现操作日志记录,必须获取用户ID、操作含义等关键信息,避免在静态资源和健康接口中记录,日志应JSON格式化并加锁写入,敏感字段须脱敏,且需定期归档或接入日志系统。

ThinkPHP 本身不自动记录用户操作行为,必须手动集成日志逻辑或借助行为(Behavior)/中间件(Middleware)机制实现。直接启用 Log::record() 或配置 log.record 只能记录框架级错误和调试信息,不会捕获“谁在什么时候做了什么”。
用中间件统一拦截请求并写入操作日志
5.1+ 版本推荐用中间件,比旧版的 Behavior 更可控、更易调试。关键点是:不能只记录 URL 和 IP,必须主动获取当前登录用户 ID 和操作含义。
- 在
app/middleware.php中注册中间件,如App\Middleware\OperationLogMiddleware - 中间件
handle()方法中,需先判断是否已登录(例如检查session('user_id')或调用你的鉴权服务),未登录则跳过记录 - 避免在静态资源(
.js、.css、/public/路径)或 API 健康检查接口(如/api/ping)上触发日志,否则日志爆炸 - 日志内容建议至少包含:
user_id、action(如'admin/user/edit')、method(POST)、ip、input(脱敏后的关键参数,如['id' => 123, 'status' => 1])
为什么不要在控制器里逐个写 Log::write()
看似简单,实则埋雷:维护成本高、容易遗漏、无法统一控制日志格式和敏感字段过滤。
- 每个
edit、delete、import方法都加日志,等于把相同逻辑复制 N 次 - 一旦要增加字段(比如加操作耗时),得改十几个文件;要屏蔽密码字段,得在每处手动
unset($data['password']) - 若控制器用了
validate()失败提前返回,可能根本没走到Log::write()那行,导致“失败操作”反而没记录 - 异步任务(如队列中的导出)不在 HTTP 请求生命周期内,控制器日志完全覆盖不到
Log::write() 写操作日志时的三个硬约束
ThinkPHP 默认日志驱动(File)不支持结构化写入,直接传数组会转成字符串,查起来极痛苦。必须自己处理格式和落盘方式。
立即学习“PHP免费学习笔记(深入)”;
- 别直接
Log::write(['user_id'=>1,'action'=>'del','ip'=>'127.0.0.1'])—— 这会变成一行无分隔的文本,grep 都难定位 - 推荐拼成标准 JSON 行:
file_put_contents(runtime/log/operation/'.date('Y-m-d').'.log', json_encode($logData, JSON_UNESCAPED_UNICODE)."\n", FILE_APPEND) - 注意并发写入:多个请求同时写同一文件可能丢行,生产环境务必用
flock()加锁,或换用数据库/Redis 存储 - 敏感字段(如
password、id_card)必须在写入前从$request->param()中显式剔除,不能依赖前端传空值
最常被忽略的是日志生命周期管理:没人清理 runtime/log/operation/ 下的文件,半年后单日志文件超 2GB,tail -f 直接卡死。要么加定时脚本按天压缩归档,要么一开始就接入 ELK 或阿里云 SLS —— 但那已经不是 ThinkPHP 能解决的事了。



















