CodeIgniter钩子配置步骤详解

本文深入解析了CodeIgniter 3.x中钩子（Hooks）机制的完整配置与使用要点，从启用开关（$config['enable_hooks'] = TRUE）这一常被忽视的前提开始，到hooks.php中钩子规则的严格语法要求、预设执行点的正确选择、路径与命名的大小写敏感性，再到不同钩子时机（如pre_system、pre_controller、post_controller_constructor）下CI实例可用性及适用场景的深度辨析——尤其强调post_controller_constructor在权限控制中的不可替代性。文章直击开发者高频踩坑点：钩子不生效常因未开启配置而非逻辑错误，get_instance()失效源于时机不当，跳转失败源于输出缓冲已启动，文件名不一致导致Linux环境静默失败等，是一份兼具原理透彻性与实战排错力的CI钩子权威指南。

怎么在 config.php 里打开钩子开关

不启用就完全没用，这是所有钩子执行的前提。很多开发者写了 hooks.php 却没生效，第一反应是钩子写错了，其实只是 $config['enable_hooks'] 还是 FALSE。

• 打开 application/config/config.php
• 搜索 enable_hooks，改成 $config['enable_hooks'] = TRUE;
• 注意：CI 4 不再支持原生钩子机制，这个配置只对 CI 3.x 有效

hooks.php 里怎么写一条合法的钩子规则

钩子定义不是随便写个数组就行，function 和 filename 是必填项，class 可空，但一旦填了就必须匹配文件里的类名，否则报 Call to undefined method。

• hook_name 必须是 CI 预设的点，比如 pre_controller、post_controller_constructor，拼错或自定义名称不会触发
• filepath 是相对于 APPPATH（即 application/）的路径，写成 application/hooks/MyHook.php 就错，得写 hooks
• 参数传入靠 params 数组，函数签名必须兼容：例如 params => ['admin', 'edit']，对应函数就得声明为 function check_perm($role = '', $action = '')

示例（检查登录态）：

$hook['pre_controller'] = array(
    'function' => 'check_login',
    'filename' => 'auth_hook.php',
    'filepath' => 'hooks'
);

钩子文件里为什么 get_instance() 有时会失效

在 pre_system 或 pre_system 钩子中调用 get_instance() 会直接报错——因为此时 CI 核心对象还没初始化。只有从 pre_controller 开始，get_instance() 才可用。

• pre_system：不能用 get_instance()，也不能加载任何库、模型；适合做环境检测、PHP 版本校验、全局常量定义
• pre_controller 起：CI 实例已存在，可安全调用 $this->CI->session、$this->CI->load->model() 等
• 如果钩子类用了构造函数，记得加 defined('BASEPATH') OR exit('No direct script access allowed'); 防止被直接访问

为什么 post_controller_constructor 比 pre_controller 更适合权限控制

因为 pre_controller 触发时控制器都还没实例化，你根本不知道用户要访问哪个方法；而 post_controller_constructor 已完成控制器实例化，能通过 $this->CI->router 拿到当前路由和方法名，做细粒度权限判断才真正可行。

• 获取当前动作：$this->CI->router->fetch_class() + $this->CI->router->fetch_method()
• 别在 post_controller 做跳转，此时输出缓冲可能已开启，redirect() 会触发 headers already sent 错误
• 若需统一拦截，优先选 post_controller_constructor，它比 pre_controller 多一个“已知目标”的确定性

实际项目里最容易漏掉的是钩子文件的路径权限和命名一致性——filename 写 AuthHook.php，但文件叫 auth_hook.php，Linux 下直接失败；还有人把钩子逻辑塞进控制器构造函数，结果每次都要手动复制，反而失去钩子“解耦”的本意。

终于介绍完啦！小伙伴们，这篇关于《CodeIgniter钩子配置步骤详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！