ThinkPHP事件机制需显式注册监听器，否则Event::trigger()无效；最常用方式是在config/event.php的listen数组中配置事件名到监听器类的映射，如'UserLogin' => [\app\listener\SendSms::class]，监听器必须含handle()方法，支持类型提示或直接接收参数。
ThinkPHP 的事件机制不是“钩子”翻版，它默认不自动加载监听器，必须显式绑定或注册，否则 Event::trigger() 什么都不会发生。
怎么注册事件监听器（listen 数组）
这是最常用、也最容易误解的方式：在 config/event.php 的 listen 数组里写事件名到监听类的映射。注意三点：
-
listen键是事件名（字符串），值是监听器类名数组，哪怕只有一个也要写成数组：'UserLogin' => [\app\listener\SendSms::class] - 监听器类必须有
handle()方法，参数可类型提示事件类，也可直接接收传入参数（如handle($user)） - 如果事件名和监听器类名不一致（比如事件叫
UserLogin，监听器叫NotifyAdmin），就只能靠listen或bind绑定，不能靠命名自动关联
为什么 bind 和 listen 都存在？区别在哪
bind 是“事件类 → 监听器类”映射，listen 是“事件名 → 监听器类”映射，二者互不替代，但行为一致：都让 Event::trigger() 能找到并执行监听器。
- 用
bind时，触发必须传事件对象实例：Event::trigger(new \app\event\UserLogin($user)) - 用
listen时，触发可用字符串名：Event::trigger('UserLogin', [$user])，更轻量，适合简单场景 - 两者可以共存；如果同一事件同时出现在
bind和listen中，监听器都会被执行
手动注册监听器（Event::listen()）什么时候用
适合运行时动态控制，比如根据配置开关某个监听逻辑，或在中间件/控制器中临时加监听：
立即学习“PHP免费学习笔记（深入）”；
- 注册写法：
Event::listen('UserLogin', \app\listener\LogLogin::class) - 注意：这种注册只对当前请求生效，不会写入配置，也不能被命令行生成工具识别
- 不要在循环里反复调用
Event::listen()，会导致重复绑定，监听器执行多次 - 如果已通过
listen数组注册过同名事件，手动注册会追加监听器，不是覆盖
事件订阅（subscribe）怎么避免方法名写错
订阅类靠方法名约定响应事件，格式是 on + 事件名（驼峰），比如事件名 UserLogin，对应方法必须是 onUserLogin()，大小写、拼写、驼峰规则全错就失效。
- 订阅类要放进
config/event.php的subscribe数组：'app\subscribe\UserActionSubscribe' - 方法参数直接接收
Event::trigger()传入的参数，不支持类型提示事件类（除非自己手动 new） - 如果一个订阅类要监听多个事件，每个都要写独立的
onXXX()方法，不能共用一个入口 - 别把订阅类当成“万能监听器”——它只是语法糖，底层仍是注册监听器，性能无优势
真正容易被忽略的是：所有注册方式（listen/bind/subscribe）都依赖 config/event.php 文件被正确加载；如果项目启用了配置缓存，改完这个文件后必须执行 php think clear:config，否则新注册不生效。
