TP5 使用 Hook 机制而非事件系统，需在 app/common.php 或 app/tags.php 中用 \think\Hook::add() 提前注册监听器，再通过 \think\Hook::listen() 触发；不可在控制器或模型中动态注册，且钩子名必须被实际调用才生效。

TP5 里没有 event() 函数，别直接调用

直接在控制器或模型里写 event('user_login') 或 Event::trigger()，一定会报 Fatal error: Uncaught Error: Call to undefined function event() 或 Class not found: think\facade\Event。TP5 根本不提供这两个东西——它用的是 \think\Hook，不是事件系统，是钩子（Hook）机制。

\think\Hook::add() 必须在初始化早期注册

注册监听器不是“哪里需要就在哪里写”，而是必须赶在框架真正开始运行前完成，否则 \think\Hook::listen() 找不到任何行为。

• 最稳妥位置是 app/common.php 或 app/tags.php（如果配合行为使用）
• 注册语法：\think\Hook::add('user_login', function($user) { echo "欢迎 {$user['name']}"; });
• 支持类方法数组：\think\Hook::add('user_login', ['app\hook\LoginLogger', 'log']);，要求方法为 public
• 别在控制器方法里注册——每次请求都重复 add，导致监听器执行多次；也别在模型 init() 里注册，模型可能还没加载完

自定义钩子名必须被实际调用，否则静默失效

\think\Hook::add('my_tag', ...) 只是往内存数组塞数据，不等于它会被执行。只有当某处代码明确写了 \think\Hook::listen('my_tag', $params)，且该行代码真正在请求生命周期中被执行，行为才会触发。

• 框架内置标签位如 app_init、view_filter 是安全的，因为它们在 App::run() 内部被调用
• 你在控制器里手动写 \think\Hook::listen('my_tag', $data)，但 my_tag 没在 tags.php 配置过，也不会报错，只是什么也不做
• 想验证是否生效？在行为类 run() 方法里加 exit('hook triggered');，页面中断才说明进去了

别把 TP5 Hook 当 TP6 Event 用

TP6 已彻底删除 \think\Hook 类，vendor 目录下找不到 Hook.php。强行复制 TP5 的 Hook 文件到 TP6 项目中，会因容器、自动加载、上下文缺失而 fatal error 或静默失败。

如果你正从 TP5 升级，记住：TP5 的 \think\Hook::add() + \think\Hook::listen() 和 TP6 的 event() / Event::trigger() 是两套互不兼容的机制，不能混用，也不能靠“改个名字”迁移。

真正容易被忽略的是：TP5 的钩子不校验参数类型、不提示错误、不记录日志——失效时既不抛异常也不输出 warning，只能靠你主动加调试断点或 exit 验证执行路径。