ThinkPHP 6.0 重构事件系统:移除 Event::listen,监听器须在 app/event.php 配置;事件触发仅接受数组或 Event 实例;监听器方法统一为 handle($event);系统钩子重命名为 AppInit 等;自定义事件类必须继承 thinkEvent。
事件注册方式变了:
不再可用
5.1 里用
注册监听,6.0 已彻底移除这个静态方法。不是改名,是整个事件注册模型重构了——监听器必须通过配置或容器绑定声明,运行时不能动态追加。
实操建议:
把所有
调用删掉,别想着兼容写法
监听器类必须实现
(可选,但推荐),且类名需与事件名语义对齐(如
事件对应
)
在
配置文件中声明映射:
注意路径:6.0 默认事件配置在
,不是
触发事件的函数名没变,但参数传递规则收紧了
这种写法在两个版本都可用,但 6.0 对参数类型更敏感:只接受数组或实现了
的对象,传字符串、数字或 null 会直接抛出
。
常见错误现象:
立即学习
“
PHP免费学习笔记(深入)
”;
升级后突然报错
,大概率是旧代码里写了
(传 int)
监听器方法签名必须是
,不再支持多参数解构(如
)
如果需要解包,得在监听器里手动从
取值:
系统事件钩子名全量重命名,别硬套 5.1 的习惯
6.0 把原来像
、
这类“魔术钩子”全部移除了,换成明确生命周期事件,比如
、
。大小写敏感,且不带下划线。
使用场景:
想在应用初始化时执行逻辑?监听
,不是
控制器执行前?用
(6.0 新增),不是
数据库查询完成?监听
,不是
所有内置事件名都在
类的常量里定义,别猜,直接查源码或看
自定义事件类必须继承
才能被识别
5.1 允许纯数组或任意对象当事件数据,6.0 要求自定义事件类显式继承
,否则
会静默失败——既不触发监听器,也不报错。
为什么这样做:
避免类型混淆,让事件流可追踪
为后续支持事件广播、异步分发留扩展空间
继承
后自动获得
和
方法,监听器行为更一致
实操建议:
新建事件类时,第一行必须是
构造函数里调用
显式设名称
别省略
,6.0 不再自动引入
最易忽略的是事件类的命名空间和自动加载——6.0 默认只扫描
和
,自定义事件类放错目录,
就会找不到类,报
而不是事件相关错误。
Event::listenEvent::listen('UserLogin', 'app\event\UserLogin')Event::listenthinkcontractEventInterfaceUserLoginUserLoginListenerapp/event.php'UserLogin' => [pplistenerUserLoginListener::class],app/event.phpconfig/event.phpevent('UserLogin', ['uid' => 123])thinkcontractEventInterfaceInvalidArgumentExceptionInvalid event data typeevent('UserLogin', $uid)handle($event)handle($uid, $ip)$eventpublic function handle($event) { $uid = $event['uid'] ?? null; }app_initaction_beginAppInitActionBeginAppInitapp_initActionBeforeaction_beginDbQuerysql_endthinkEventvendor/topthink/framework/src/think/Event.phpthinkEventthinkEventevent(new UserLoginEvent())thinkEventgetName()getParams()class UserLoginEvent extends hinkEventparent::__construct('UserLogin')use thinkEvent;appeventapplistenerevent(new XxxEvent())Class not found