ThinkPHP用户行为日志开发-ThinkPHP-PHP中文网

thinkphp用户行为日志需在中间件中安全捕获上下文：过滤敏感参数、多层校验真实ip、实时获取session用户id；json日志须转义、加锁、绝对路径、单行格式；数据库字段应分拆设计并建索引；钩子须显式注册、正确触发、异步处理。

thinkphp用户行为日志开发

ThinkPHP 不自带用户行为日志，必须自己搭结构；直接在控制器里写 Log::write() 看似快，实际维护崩溃、审计失效、敏感字段裸奔。

关键不是“有没有记录”，而是“记录的内容是否可信且可查”。$request->param() 要过滤敏感键，$request->ip() 不能信默认值，session 用户 ID 必须实时取、不能缓存。

用 $request->except(['token', 'password', 'sign']) 拿参数，别用 input() 或原样 dump $_POST
真实 IP 需多层 fallback：$request->header('X-Forwarded-For') → $request->header('X-Real-IP') → $request->ip()，每层都做 IPv4/IPv6 格式校验
登录态判断必须带 session 启动检查：if ($request->session()->isStarted() && $request->session()->get('user_id'))，否则 CLI 或异常场景会静默写入空 user_id
未登录用户统一设为 'guest' 或 null，禁止 fallback 到 UA 或 IP 伪造标识

不加锁、不格式化、不转义的文件写入，在生产环境等于埋定时炸弹：并发时丢行、中文变乱码、grep 查不到、ELK 解析失败。

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

下载

必须用 json_encode($logData, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)，否则日志里出现 u540du79f0 或双斜杠，后续分析全废
写入前加 flock($fp, LOCK_EX)，或改用 error_log($line, 3, $path)（它底层是系统调用，更轻量）
路径必须绝对：/var/www/myapp/runtime/log/operation/ + date('Y-m-d').'.log'，相对路径在 CLI 或队列中极易写错目录
每行一条 JSON，末尾加 " "，否则 awk 和 jq 工具无法按行解析

把所有内容塞进一个 TEXT 字段，等于放弃日志价值。查“某管理员删过哪些用户”要全表扫描，加个索引都加不上。

user_id 字段必须为 INT UNSIGNED NULL（未登录留 NULL），别用 VARCHAR 存数字，关联查询会失效
action 字段建议拆出 module、controller、action 三列，从 $request->rule()->getModule() 等方法取，别解析 URL 字符串
params 推荐 MySQL 5.7+ 的 JSON 类型，方便后续查 SELECT * FROM log WHERE params->'$.id' = 123
ip 字段必须 VARCHAR(45)，IPv6 地址最长 45 字符，用 INET_ATON() 会截断
高频查询字段如 user_id、created_at 必须联合建索引，否则日志表撑不过一周

不是钩子不行，是注册和触发时机错了。挂太早没 session，挂太晚已响应，或者根本没在配置里声明，框架压根不认这个行为类。

钩子名必须显式注册：在 app/middleware.php 或行为配置文件里加 'login_success' => ['app\common\behavior\LoginLogBehavior']
触发点必须在 session 写入之后——比如 LoginController 中 Session::set('user_id', $uid) 执行完，再调 Hook::listen('login_success', [...])
行为类里禁止同步 IO 操作，file_put_contents() 或 DB 插入必须扔进队列，否则登录接口 P99 直接翻倍
钩子参数只传审计必需字段：uid、username、ip、status，绝不能传 $user 全数组，里面可能含密码哈希或 token