CodeIgniter钩子使用与事件应用教程

CodeIgniter框架的钩子（Hooks）功能，允许开发者在不修改核心文件的前提下，于特定执行点插入自定义代码，实现灵活的流程控制和功能扩展。本教程详细讲解如何使用CodeIgniter钩子，包括启用钩子、定义预定义的钩子事件（如`pre_controller`、`post_system`等）、配置钩子规则（定义类、方法、文件路径等），以及创建对应的钩子类文件。通过`get_instance()`方法，可以在钩子函数中调用CodeIgniter的资源，实现诸如权限验证、安全检查、日志记录等功能。同时，文章还介绍了如何在同一事件上绑定多个钩子，从而实现更复杂的逻辑处理。掌握CodeIgniter钩子的使用，能有效提升Web应用的开发效率和可维护性。

CodeIgniter钩子通过启用配置并定义事件实现流程控制，如在pre_controller执行权限验证，需在hooks.php中设置类、方法、文件路径等参数，并创建对应钩子类文件，利用get_instance()调用CI资源，支持多钩子绑定，适用于全局拦截与监控。

CodeIgniter 钩子（Hooks）是一种允许你在不修改核心文件的情况下，在特定的执行点插入自定义代码的机制。通过启用和配置钩子，你可以实现如请求前处理、权限验证、日志记录等功能。

1. 启用钩子功能

默认情况下，CodeIgniter 的钩子是关闭的。你需要先在 application/config/config.php 文件中开启钩子：

2. 定义钩子事件

CodeIgniter 提供了多个预定义的执行点（即钩子事件），你可以在这些时机运行自定义逻辑。常用钩子事件包括：

• pre_system：系统完全启动之前执行，此时控制器还未加载
• post_system：请求结束后执行，页面输出完成后触发
• pre_controller：控制器加载之前执行
• post_controller：控制器方法执行后、输出发送前触发
• post_controller_constructor：控制器构造函数执行之后运行
• cache_override：用于自定义输出缓存逻辑

3. 配置钩子规则

打开 application/config/hooks.php 文件，使用数组方式定义钩子。基本结构如下：

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

说明：

• class：包含回调方法的类名（可为空）
• function：要执行的方法或函数名
• filename：包含该类或函数的文件名
• filepath：文件所在目录（相对于 application/ 目录，如 hooks、libraries 等）
• params：传递给函数的参数数组（可选）

4. 创建钩子文件

在 application/hooks/ 目录下创建对应的钩子类文件，例如 AuthHook.php：

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class AuthHook {

    private $CI;

    public function __construct() {
        $this->CI =& get_instance(); // 获取 CI 实例
    }

    public function check_login($param1 = '', $param2 = '') {
        // 示例：检查用户是否登录
        if (uri_string() == 'admin/dashboard') {
            if (!$this->CI->session->userdata('logged_in')) {
                redirect('login');
            }
        }
    }
}

注意：使用 get_instance() 来获取当前 CI 对象，以便调用模型、库、辅助函数等。

5. 多个钩子或同一事件多个处理

如果需要在同一事件上绑定多个钩子，可以使用二维数组：

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

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

到这里，我们也就讲完了《CodeIgniter钩子使用与事件应用教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！