ThinkPHP MVC架构事件监听与钩子函数解耦

在ThinkPHP里，事件和钩子这两个概念，最容易让人犯迷糊。不少新同学会把它们混为一谈，但用错了地方，很可能导致逻辑跑偏或者功能静默失效，调试起来还找不到头绪。它们的核心区别其实在于：钩子，是用来干预框架生命周期的；而事件，则是用来解耦业务动作的。

打个比方，钩子就像一个安检员，在框架的各个必经路口（比如控制器执行前、模板渲染完）检查通行；事件则像是一个广播台，业务代码可以对外广播消息（比如“用户注册成功了”），然后让各个相关的监听器去响应（记录日志、发邮件、更新统计等）。两者都能实现解耦，但定位、注册方式和参数规则，完全是两码事。

钩子函数：专注框架流程干预

钩子是绑定在框架内置的“标签位”上的，像app_init、action_begin、view_filter这些都是。它的本质是一种AOP（面向切面编程）式的扩展，只关心“在什么时机执行”，并不关心背后的业务含义。

• 行为类必须定义一个run()方法（当然也能自定义入口名，但得统一配置）。
• 注册方式，是在app/tags.php这个配置文件里声明的。格式大概是这样：'action_begin' => ['app\common\beha vior\LogBeha vior']。
• 参数是框架自动传递的。比如action_begin会传入当前的回调函数，view_filter会传入待渲染的内容。
• 它支持多个行为按数组顺序执行，很适合做权限校验、日志埋点、输出内容过滤这类横切逻辑。

事件监听：专注业务动作响应

事件是标准的发布-订阅模式。它由业务代码主动触发，比如用户登录成功后，调用了 Event::trigger('user.login', [$user, $ip])，然后所有对这个事件感兴趣的监听器都会收到通知。

• 监听器类推荐继承think\listener\Listener，并实现handle()方法。
• 注册统一写在app/event.php里，键是事件名，值是监听器类的数组：'user.login' => ['app\listener\LoginLogListener']。
• 触发事件时，第二个参数必须是个数组，而且数组元素的个数和类型，要严格匹配监听器handle()方法的签名。
• 还可以用priority参数来控制监听器的执行顺序，值越大执行越早，免得因为加载顺序出问题。

常见踩坑点与应对

很多问题并不是语法错误，而是对机制的理解偏差，导致函数悄无声息地罢工。

• 监听器没反应？第一步检查，看它是不是注册到了app/event.php（而不是tags.php），而且值必须是数组，不能是字符串。
• 命令行或队列里事件不触发？需要手动加载一下配置：Event::import(config('event'))，并且得确保应用已经初始化。
• 监听器里用不了Db或Cache？千万别直接new实例，用app('db')或app()->make('cache')这种容器方式来获取。
• TP6里用了TP5的Hook类？TP6已经不再支持TP5的Hook类了。强行引入，框架不会有任何报错，但也不会执行任何代码——这是容器绑定缺失导致的静默失效，非常坑。

怎么选：钩子 or 事件？

判断的标准其实很直接：这个逻辑，是和框架的执行阶段强相关，还是和业务动作强相关？

• 系统级流程节点（比如请求开始、视图输出）→ 用钩子。
• 明确的业务动作（比如订单创建、密码重置）→ 用事件。
• 需要跨模块响应同一动作（比如注册后要发信息、写日志、通知客服）→ 必须用事件。
• 只需要在控制器方法前统一校验登录态→ 用钩子或者中间件更直接，用事件反而绕远了。