跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

ThinkPHP事件机制在5.1与6.0版本的差异与迁移指南

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

相关文章