ThinkPHP 6.x 已移除 Hook 类，必须改用事件系统替代；需新建监听器类实现 handle() 方法并绑定到 app/event.php，且确保容器初始化后触发事件。
Hook 类方法调用直接报错：Class 'Hook' not found
ThinkPHP 6.x 已彻底移除 Hook 类，所有基于 Hook::add()、Hook::listen() 的代码会直接抛出类未定义错误。这不是命名空间问题，是底层类被删了。
必须改用事件系统替代，且不能简单“替换函数名”。关键差异在于：Hook 是静态全局注册+即时触发；事件系统是容器驱动、支持依赖注入、需显式绑定监听器。
- 旧 Hook 注册写法：
Hook::add('app_init', 'app\behavior\CheckAuth')→ 现在无效 - 新事件绑定方式：在
app/event.php中配置，或通过Event::listen()动态绑定 - 监听器类必须实现
thinkcontractEventInterface或使用闭包（推荐前者，便于复用）
如何把原有 Hook 行为类迁移到 Event 监听器
原 Hook 行为类（如 app/behavior/CheckAuth.php）通常只含一个 run() 方法。迁移时不能照搬，因为事件监听器的执行签名和生命周期不同。
事件监听器接收的是具体事件对象，不是原始参数列表。比如 app_init 对应的事件类是 thinkeventAppInit，监听器方法签名必须是 handle(AppInit $event)。
立即学习“PHP免费学习笔记（深入）”；
- 新建监听器类，例如
app/listener/AppInitCheckAuth.php - 类中定义
handle()方法，参数类型声明为对应事件类（thinkeventAppInit等） - 在
app/event.php中绑定：['app_init' => ['app\listener\AppInitCheckAuth']] - 若需访问请求对象，从事件对象中取：
$event->app->request，而非直接用Request::instance()
动态监听（类似旧 Hook::listen()）但不推荐在业务逻辑里硬编码
有些场景需要运行时决定是否触发某逻辑（比如插件动态启用），确实要用 Event::trigger() 或 Event::listen()。但要注意：这些调用必须在容器初始化之后，否则监听器不会生效。
常见踩坑点是放在控制器构造函数或早期中间件里调用 Event::listen()，此时容器尚未加载事件服务，绑定失败且无提示。
- 安全位置：应用启动后（如
app/common.php）、中间件的handle()方法内、或事件监听器自身内部 - 动态监听示例：
Event::listen('user_login', function ($user) { Log::info('User logged in: ' . $user['id']); }); - 触发事件必须用完整命名空间类名：
Event::trigger(new hinkeventUserLogin($userInfo))，不能传字符串
兼容旧 Hook 风格的简易封装（仅限过渡期）
项目大、Hook 调用分散，短期内无法全部重写，可建一个轻量适配层，但仅限临时过渡。它不能解决事件生命周期、依赖注入等本质差异，只是避免大面积报错。
核心思路：在 app/helper.php 中定义 hook_add() 和 hook_listen() 函数，内部转成事件绑定与触发。但注意——它无法还原 Hook 的“多对一”聚合监听能力，也不支持优先级。
- 不要在生产环境长期保留该封装，它掩盖了事件系统的真正用法
- 监听器类仍需按事件规范编写，封装层只是桥接调用入口
- 若原 Hook 传入的是字符串行为名（如
'app\behavior\LogRecord'），需确保该类已按事件监听器格式重写
