在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 事件?
判断的标准其实很直接:这个逻辑,是和框架的执行阶段强相关,还是和业务动作强相关?
- 系统级流程节点(比如请求开始、视图输出)→ 用钩子。
- 明确的业务动作(比如订单创建、密码重置)→ 用事件。
- 需要跨模块响应同一动作(比如注册后要发信息、写日志、通知客服)→ 必须用事件。
- 只需要在控制器方法前统一校验登录态→ 用钩子或者中间件更直接,用事件反而绕远了。
