事件类应继承think\event或明确为dto，推荐public属性和简洁构造函数；监听器handle()参数类型须严格匹配事件类；注册必须在config/event.php中完成，订阅者适用于多事件聚合管理。
事件类必须继承 think\Event 或明确作为 DTO
不强制继承，但继承 think\Event 能获得框架级一致性支持（如自动类型提示、IDE 识别、调试时的事件上下文追踪）。若只传简单数据，用纯 PHP 类也行，但得确保构造参数清晰、属性公开或提供 getter。
常见错误现象：UserRegistered 类里写 private $user 却没 getter，监听器里直接访问 $event->user 报错；或者构造函数参数顺序混乱，触发时传参错位导致空对象。
- 推荐写法：声明
public $user，构造函数只接收必要参数，不做业务逻辑 - 避免在事件类里调用 DB、发邮件等副作用操作——它只是“信封”，不是“邮局”
- 多个参数建议封装为数组字段（如
public $context = []），而非堆砌 5 个 public 属性
handle() 方法签名必须匹配事件类型
监听器的 handle() 方法形参类型必须与触发时传入的事件对象严格一致。ThinkPHP 8 会做运行时类型校验，类型不符直接抛 TypeError，且不会 fallback 到其他重载方法。
使用场景：你定义了 app\event\UserRegistered，监听器就得写 public function handle(UserRegistered $event)，不能写 function handle($event) 或 function handle(Event $event)。
- 如果事件是字符串触发（如
event('user_login')），监听器方法就该是handle($event)，此时 $event 是原始参数（数组或字符串） - 混合使用字符串事件和类事件时，别在同一个监听器里混写两种
handle签名——PHP 不支持方法重载 - IDE 提示不准？检查
use语句是否漏了事件类的完整命名空间
监听器注册必须走 config/event.php 的 listen 键
别在控制器或服务里手动调用 Event::listen() 动态注册——这会导致热更新失效、命令行环境丢失监听、Swoole 长连接下重复注册等问题。
正确注册位置唯一：config/event.php 中的 'listen' => [...] 数组。键是事件标识（类名或字符串），值是监听器类名数组。
- 字符串事件：键写
'user_login_success'，值写[\app\listener\UserLoginLog::class] - 事件类：键写
app\event\UserRegistered::class，注意双反斜杠转义或用常量UserRegistered::class - 一个事件可绑定多个监听器，顺序即执行顺序；想控制优先级，就调整数组索引位置
订阅者（EventSubscriberInterface）适合多事件聚合管理
当一个业务模块要响应 3 个以上事件（比如用户模块要处理注册、登录、登出、密码修改），用订阅者比在 event.php 里逐条写 listen 更清晰、更易维护。
关键点：订阅者类必须实现 getSubscribedEvents() 静态方法，返回关联数组，键是事件类/字符串，值是本类中对应的方法名（如 'handleUserRegistered'）。
- 方法名不必以
on或handle开头，但必须是 public 且存在 - 订阅者本身不自动注册，需在
event.php的'subscribe'键里显式列出类名 - 别在订阅者方法里做耗时操作（如 HTTP 请求），它和普通监听器一样同步执行，卡住整个请求流程
最易被忽略的是事件类的自动加载路径——ThinkPHP 默认只扫描 app\event 目录，如果你把事件类放在 app\common\event 下，又没配 PSR-4 自动加载规则，event() 触发时会报类找不到，而不是事件未监听。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
