TP5 没有 event() 函数和 think\facade\Event 类，使用 Hook 机制（\think\Hook）替代；注册需在初始化早期调用 \think\Hook::add()，触发用 \think\Hook::trigger()，参数直传、不报错、易静默失效。
ThinkPHP 5.x 没有内置 event() 辅助函数，也没有 think\facade\Event 类，直接写 event('UserLogin') 或 Event::trigger() 必然报错或静默失效——它用的是 Hook 机制，不是 TP6 的 Event 系统。
为什么 event() 在 TP5 里根本不存在
TP5 的事件系统叫「Hook」，底层基于 spl 的 Event 扩展（非框架类），核心是 \think\Hook 静态类。它不支持事件类、监听器类自动绑定，也不读 config/event.php，所有注册必须手动调用 \think\Hook::add()。
-
event()是 TP6+ 引入的助手函数，TP5 中未定义，调用即Fatal error: Uncaught Error: Call to undefined function event() -
think\facade\Event在 TP5 中不存在，use think\facade\Event会触发Class not found - TP5 的
Hook不区分「事件名」和「事件类」，只认字符串标识，如'user_login'，不支持类型提示或构造注入
\think\Hook::add() 怎么注册才生效
注册必须在应用初始化早期完成，否则后续 trigger() 找不到监听器。最稳妥位置是 app/common.php 或 app/tags.php（若配合行为使用）。
- 注册语法：
\think\Hook::add('user_login', function($user) { echo "欢迎 {$user['name']}"; }); - 可注册多个同名钩子，按注册顺序执行：
\think\Hook::add('user_login', [...]);多次调用会追加，不是覆盖 - 闭包外也可传类方法数组：
\think\Hook::add('user_login', ['app\hook\LoginLogger', 'log']);，要求方法为public - 别在控制器里注册——每次请求都重复 add，导致监听器执行多次；也别在模型
init()里注册，模型可能未加载完 Hook 系统
\think\Hook::trigger() 触发时常见失效原因
触发失败几乎从不报错，而是静默跳过，排查重点在「是否注册」「参数传递方式」「作用域隔离」。
立即学习“PHP免费学习笔记（深入）”；
- 触发前未调用
add()：最常见，尤其在命令行环境，common.php可能没加载 - 参数类型错位：钩子回调接收的是
trigger()的第二个参数原样传递，\think\Hook::trigger('user_login', $user)→ 闭包接收$user，不是封装对象 - CLI 环境下配置分离：TP5 的命令行入口（如
think）默认不加载app/common.php，需手动在命令类handle()开头补注册，或改用tags.php统一管理 - 命名空间拼写错误：比如
['app\hook\LoginLogger', 'log']中类文件实际在app/hook/login_logger.php但声明了namespace app\hook;，而文件名是小写，Windows 下可能忽略，Linux 下 autoload 失败
想在 TP5 里模拟 TP6 的事件类 + 监听器模式，怎么安全封装
可以自己封装一个 event() 函数，但必须绕过 TP5 原生限制，且要控制加载时机和类自动解析。
- 在
app/common.php末尾添加函数定义：function event($name, $params = null) { $list = config("event.listen.{$name}"); if (!$list) return; foreach ($list as $listener) { if (is_string($listener) && class_exists($listener)) { $obj = new $listener(); if (method_exists($obj, 'handle')) { $obj->handle($params); } } } } - 配套在
config/event.php中写：return [ 'listen' => [ 'user_login' => ['app\listener\UserLoginLogger'], ], ]; - 监听器类需手动确保可被 autoload：类文件放
app/listener/UserLoginLogger.php，命名空间为app\listener，含public function handle($params) - 此方案不改变 TP5 内核，但失去 Hook 的多点触发能力；若需同时兼容原有 Hook 钩子，得在封装函数里混合调用
\think\Hook::trigger()
TP5 的 Hook 是轻量字符串匹配，没有事件调度器、无依赖注入、不校验监听器签名——它的“简单”就是双刃剑：容易上手，也容易在跨环境、多模块协作时漏注册或参数错位。真正要解耦复杂逻辑，与其强行模拟 TP6，不如尽早升级，或用队列 + 自定义事件总线替代。
