在ThinkPHP 5.1中注入自定义逻辑必须通过框架预置标签位（如app_init、app_begin、action_begin、view_filter、app_end）注册行为类，手动调用Hook::listen或使用未被App::run()调用的钩子将无效。
在ThinkPHP 5.1中为应用注入自定义逻辑，必须依托框架预埋的标签位（如app_init、view_filter）执行行为类，跳过这一步直接写run()方法或手动调用Hook::listen()将不会触发任何行为。
确认可用的内置标签位
打开ThinkPHP 5.1源码中的thinkphp/library/think/App.php，找到App::run()方法内部调用Hook::listen()的位置——只有这里明确出现的钩子名才真实有效。常见且稳定可用的有：【app_init、app_begin、action_begin、view_filter、app_end】。不要使用文档里列出但未被App::run()实际调用的钩子（如log_level），它只会静默失效。
自定义钩子名（如user_login）不能靠配置自动生效，必须在业务代码中显式调用Hook::listen('user_login', $data)，且该调用位置需处于框架流程可感知的上下文中（例如控制器方法内），否则仍不执行。
编写行为类文件
在application/common/behavior/目录下新建CheckAuth.php：
立即学习“PHP免费学习笔记（深入）”；
命名空间必须完整且PSR-4兼容，类名首字母大写，文件名与类名严格一致；【不能带__construct()构造方法，不能依赖Request或input()等未初始化对象】。
行为类必须实现public function run($params = null)，即使不用参数也得保留签名。例如app_init阶段不传参，$params就是null；而view_filter会把模板输出内容作为字符串传入，此时可对$content做替换或记录。
注册行为到tags.php
编辑application/tags.php，确保文件存在且return一个关联数组：
只允许写在这里，写在控制器、中间件或模型里等于白写；【键名必须是小写钩子名，值必须是包含完整命名空间的字符串数组】。例如：
return [ 'app_init' => ['app\common\behavior\CheckAuth'], 'view_filter' => ['app\common\behavior\ContentReplace'],];
验证行为是否生效
第一步：清空runtime/cache/和runtime/log/目录，避免旧缓存干扰；
第二步：在行为类run()方法开头加入trace('CheckAuth executed', 'behavior');；
第三步：访问任意页面，在runtime/log/下查看当天日志文件，搜索behavior关键字；
第四步：若无记录，检查tags.php路径是否为application/tags.php（不是app/tags.php）、类文件是否可被自动加载（命名空间与物理路径是否完全匹配）、是否误用了TP6语法（如use think\Hook）；
第五步：确认未在run()中调用request()->ip()等——app_init阶段Request对象尚未创建，会返回null导致逻辑中断。
