CodeIgniter事件机制使用教程

CodeIgniter 并不提供现代框架中常见的动态事件总线（如 dispatch_event），而是采用轻量、静态、配置驱动的钩子（Hook）机制——它通过在 config.php 中显式启用、在 hooks.php 中声明固定生命周期节点（如 pre_controller、display_override）来插入逻辑，强调约定优于配置；但这也意味着钩子文件路径需严格遵循 APPPATH 相对规则，类中调用 CI 核心组件必须依赖 get_instance()，且不同钩子点可访问的对象范围截然不同，选错时机轻则逻辑失效、重则引发致命错误；对于习惯 Laravel 或 Symfony 事件系统的开发者而言，理解这种“静默失败、零提示、强约定”的设计哲学，是高效驾驭 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学习网公众号也会发布文章相关知识，快来关注吧！