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