ThinkPHP 的 event() 不支持直接传参，必须通过第三个参数（数组）显式传递，如 event('UserLogin', null, ['uid' => 123])；第二个参数若非 null 会被误判为监听器类名，导致参数丢失。
ThinkPHP 的事件不支持直接传参，必须通过 event() 的第三个参数（数组）显式传递，否则监听器收不到任何自定义数据。
为什么 event('UserLogin') 拿不到用户 ID？
因为 ThinkPHP 默认只把事件名当字符串触发，event() 第二个参数（数据）若不传或传 null，监听器里 $params 就是空数组。常见错误写法：event('UserLogin', $user) —— 这里 $user 会被当成“事件类名”处理，不是参数。
- 正确做法：用第三个参数传数组，例如
event('UserLogin', null, ['uid' => 123, 'ip' => $request->ip()]) - 监听器接收方式固定为
public function handle($params)，$params就是上面那个数组 - 如果想兼容旧版写法（如 TP6.0 之前习惯），注意 6.1+ 已移除对第二个参数作为数据的隐式支持
event() 三个参数到底各起什么作用？
TP6+ 的 event() 签名是 event(string $name, mixed $class = null, array $params = [])，别被名字误导：
-
$name：纯事件标识符，如'OrderPaid'，不参与参数传递 -
$class：指定监听器类（可选），不是数据容器；设为null表示用配置中注册的全部监听器 -
$params：唯一合法的参数载体，必须是数组；键名任意，但建议语义清晰（如'order_id'而非'data'）
监听器里怎么安全取参数？
别直接 $params['uid']，容易报 Undefined index。实际项目中建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
isset($params['uid'])或array_key_exists('uid', $params)判空 - 更稳妥用
$params['uid'] ?? 0或Arr::get($params, 'uid', 0)（需 use think\helper\Arr） - 如果参数结构复杂（如嵌套数组），提前在事件触发处做
array_filter()或array_merge()规范化，避免监听器各自判断 - 调试时可在监听器开头加
Log::info('UserLogin event params', $params)，确认传入内容是否符合预期
传对象会出问题吗？
可以传对象，但要注意生命周期和序列化限制：
- 传
new User()没问题，监听器能正常调用方法 - 但如果监听器在队列中异步执行（比如用
think-queue），对象可能无法反序列化，尤其含闭包、资源句柄或 PDO 实例时 - 推荐只传简单数组或 JSON 可序列化的标量值；真要传对象，先转成数组：
['id' => $user->id, 'name' => $user->name] - TP 自带的
Event::trigger()底层不深拷贝，传引用对象后在监听器里修改会影响原始变量，慎用
最常被忽略的一点：事件参数没有类型校验，也没有文档自动同步。一旦多个监听器依赖同一组 key，改一个地方就得全局搜 'uid' —— 建议抽成常量或接口契约，比如定义 UserLoginEvent::PARAMS 数组并复用。
