ThinkPHP如何利用路由实现请求日志记录_路由钩子函数应用-ThinkPHP-PHP中文网

thinkphp 6 路由层日志应使用 beforeaction 钩子，在 route::rule() 中传闭包获取 $request 和 $option，记录 url、方法、参数及关键的 $option['rule'] 路由规则字符串，避免用中间件或事件。

thinkphp如何利用路由实现请求日志记录_路由钩子函数应用

ThinkPHP 路由层怎么加日志记录？别动控制器，用 `beforeAction` 钩子

直接在路由定义里挂日志逻辑，比在每个控制器方法里写 Log::write() 干净得多。ThinkPHP 6 的 beforeAction 是最贴合「请求入口打点」的钩子——它在控制器执行前触发，已解析完路由、参数、中间件，但尚未进业务逻辑，此时拿 $request->url()、$request->method()、$request->param() 都是准的。

常见错误是把日志塞进全局中间件：中间件可能被跳过（比如 allowCrossDomain 或静态资源路由），也可能重复执行（多个中间件链）。而路由钩子只对匹配到该路由规则的请求生效，粒度可控。

只对注册了钩子的路由生效，不影响未配置的接口
能拿到完整路由变量，比如 id、type 这类绑定在 URL 中的参数，$request->param() 已合并路由参数和 query
若需记录响应耗时，得配合 afterAction 钩子一起用，单靠 beforeAction 只能记开始时间

`Route::rule()` 里怎么写钩子？传闭包还是数组？

必须用闭包形式传入 beforeAction，数组方式（如 ['before_action' => 'log']）在 TP6+ 不被识别。闭包第一个参数是 $request 对象，第二个是当前路由的 $option 数组（含 route、var 等），别漏掉。

典型写法：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

Route::rule('api/:controller/:action', 'api/:controller/:action')
    ->beforeAction(function ($request, $option) {
        Log::write(sprintf('[ROUTE] %s %s | params: %s', 
            $request->method(), 
            $request->url(true), 
            json_encode($request->param(), JSON_UNESCAPED_UNICODE)
        ), 'info');
    });

闭包里不能用 $this，没有上下文对象；所有依赖要提前注入或用门面（如 Log::）
如果路由用了域名绑定（Route::domain()），钩子仍有效，但 $request->url(true) 返回的是带域名的完整地址，注意日志体积
避免在钩子里做阻断操作（如抛异常、exit），TP 不保证钩子执行后的流程一致性

为什么不用 `app_init` 或 `action_begin` 事件？

app_init 太早，路由还没解析，$request->path() 是原始路径，$request->param() 为空；action_begin 又太晚，已进入控制器实例化阶段，部分中间件可能已修改请求数据，且无法区分是哪个路由规则匹配的。

更关键的是兼容性问题：action_begin 在 TP6.1+ 被标记为「不推荐」，官方文档明确建议用路由钩子替代。

beforeAction 是唯一能稳定拿到「路由解析后、控制器执行前」上下文的位置
事件机制（Event::trigger()）有额外开销，尤其高并发下，钩子是原生调用，无反射、无监听器遍历
若项目启用了路由缓存（route_cache），事件监听器可能因缓存失效而漏触发，钩子不受影响

记录内容里最容易丢的关键字段是什么？

不是 URL，也不是参数，而是 route_rule —— 即实际匹配上的那条路由规则字符串，比如 'user/:id' => 'index/user/read' 中的 user/:id。这个值不在 $request 里，得从钩子第二个参数 $option['rule'] 拿。

没记录它，日志就失去路由维度的聚合能力：你看到一百条 /user/123 请求，但不知道它们是走的 RESTful 规则、还是 fallback 规则、还是某个模块专用路由，排查分流策略或灰度发布时会卡住。

正确取法：$option['rule'] ?? 'unknown'，注意空值兜底
别用 $request->rule()，这个方法返回的是控制器/操作名映射，不是原始路由表达式
如果项目用了多级子域名或 Route::group()，$option 里还会有 domain、prefix 字段，一并记下来能省掉后续关联查询

事情说清了就结束。