CodeIgniter事件机制详解与使用方法

CodeIgniter 并不提供现代框架常见的动态事件总线机制，而是采用轻量、静态声明式的钩子（Hook）系统——它依赖配置驱动、生命周期固定的执行点，在关键阶段插入自定义逻辑；启用前必须手动开启 `$config['enable_hooks'] = TRUE`，并在 `application/config/hooks.php` 中严格按约定格式配置钩子点、类路径及方法，同时注意不同钩子点对 CI 核心组件的访问限制（如 `pre_system` 中无法调用 `get_instance()`，而 `pre_controller` 则适合登录拦截），整个机制强调目录隔离与配置解耦，虽无运行时订阅/发布能力，却以极简设计实现了可控、可预测的扩展性，是理解 CodeIgniter 架构思想的关键一环。

CodeIgniter 本身没有内置的“事件总线”或 dispatch_event() 这类现代事件系统，它用的是轻量级、静态声明式的钩子（Hook）机制——不是运行时动态订阅/发布，而是配置驱动、生命周期固定点插入逻辑。

怎么启用钩子功能：先改 config.php

不开启就完全无效，这是最容易漏掉的第一步。打开 application/config/config.php，确认这行是 TRUE：

$config['enable_hooks'] = TRUE;

注意：enable_hooks 默认是 FALSE，且框架不会报错提示你忘了开——它只是静默跳过所有钩子加载逻辑。

钩子定义必须写在 hooks.php，不能放别处

application/config/hooks.php 是唯一被框架自动读取的钩子配置文件，它必须返回一个全局变量 $hook（数组）。常见错误包括：

• 把钩子配置写进 autoload.php 或控制器里
• 文件名拼错成 hook.php 或 hooks_config.php
• 没加 defined('BASEPATH') OR exit('No direct script access allowed'); 导致被直接访问时暴露路径

正确结构示例（用于登录检查）：

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

钩子文件位置和加载规则：路径必须相对于 APPPATH

filepath 值是相对于 APPPATH（即 application/ 目录）的，不是相对于项目根目录。比如：

• 'filepath' => 'hooks' → 实际路径是 application/hooks/
• 'filepath' => 'libraries/myevents' → 就是 application/libraries/myevents/

文件必须存在且可读，否则 CI 会静默跳过该钩子（不报错、不记录日志），调试时容易误判为逻辑没执行。

钩子类中若需调用 CI 核心对象（如 $this->session、$this->db），必须用 get_instance() 获取实例：

class AuthHook {
    private $CI;
    public function __construct() {
        $this->CI =& get_instance(); // 必须这样写
    }
    public function check_login() {
        if (!$this->CI->session->userdata('logged_in')) {
            redirect('login');
        }
    }
}

钩子点选错会导致逻辑失效或报错

不同钩子点能访问的 CI 组件范围不同。例如：

• pre_system：连 get_instance() 都还没初始化，不能用任何 CI 类
• pre_controller：可安全使用 get_instance()，但模型、数据库等尚未加载
• post_controller_constructor：控制器已实例化，但方法还没执行，适合做统一资源注入
• display_override：输出已被捕获到缓冲区，$this->output->get_output() 才有效

想在页面渲染前修改 HTML？用 display_override；想拦截未登录用户？用 pre_controller；想做请求后清理？用 post_system。选错点，要么拿不到数据，要么触发 PHP 致命错误（比如在 pre_system 里调 get_instance()）。

钩子机制本质是“配置 + 约定”，没有反射、没有事件名注册、不支持运行时动态添加——它的松耦合是靠目录隔离和配置解耦实现的，不是靠消息总线。真要实现类似 Laravel 的事件系统，得自己封装或引入第三方库，原生 CI 不提供。

理论要掌握，实操不能落！以上关于《CodeIgniter事件机制详解与使用方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！