CI框架 -- 核心文件 之 Hooks.php

钩子 - 扩展框架核心

CodeIgniter 的钩子特性提供了一种方法来修改框架的内部运作流程，而无需修改 核心文件。CodeIgniter 的运行遵循着一个特定的流程，你可以参考这个页面的 应用程序流程图 。但是，有些时候你可能希望在 执行流程中的某些阶段添加一些动作，例如在控制器加载之前或之后执行一段脚本， 或者在其他的某些位置触发你的脚本。

 

启用钩子

钩子特性可以在 application/config/config.php 文件中全局的启用或禁用， 设置下面这个参数: $config['enable_hooks'] = TRUE;

 

挂钩点

CI框架可以实现在不修改系统核心文件的基础上来改变或增加系统的核心运行功能，那就是Hook,看看CI有哪些钩子：

• • pre_system
    系统执行的早期调用.仅仅在benchmark 和 hooks 类 加载完毕的时候. 没有执行路由或者其它的过程.
  • pre_controller
    在调用你的任何控制器之前调用.此时所用的基础类,路由选择和安全性检查都已完成.
  • post_controller_constructor
    在你的控制器实例化之后,任何方法调用之前调用.
  • post_controller
    在你的控制器完全运行之后调用.
  • display_override
    覆盖_display()函数, 用来在系统执行末尾向web浏览器发送最终页面.这允许你用自己的方法来显示.注意，你需要通过 $this->CI =& get_instance() 引用 CI 超级对象，然后这样的最终数据可以通过调用 $this->CI->output->get_output() 来获得。
  • cache_override
    可以让你调用自己的函数来取代output类中的_display_cache() 函数.这可以让你使用自己的缓存显示方法
  • post_system
    在最终着色页面发送到浏览器之后,浏览器接收完最终数据的系统执行末尾调用  

 

定义钩子

1 $hook['pre_controller'] = array(
2                                 'class'    => 'TestHook', //调用的类名，如果你更喜欢使用过程式的函数的话，这一项可以留空。
3                                 'function' => 'test', //调用的函数名
4                                 'filename' => 'TestHook.php', //包含你的类或函数的文件名
5                                 'filepath' => 'hooks', //包含你的脚本文件的目录名。 注意： 你的脚本必须放在 application/ 目录里面，所以 filepath 是相对 application/ 目录的路径，举例来说，如果你的脚本位于 application/hooks/ ，那么 filepath 可以简单的设置为 'hooks' ，如果你的脚本位于application/hooks/utilities/ ， 那么 filepath 可以设置为 'hooks/utilities' ，路径后面不用加斜线
6                                 'params'   => 'array()'//传递给脚本参数，可选
7                                 );

 

多次调用同一个挂钩点

如果你想在同一个挂钩点处添加多个脚本，只需要将钩子数组变成二维数组即可，像这样:

$hook['pre_controller'][] = array(
    'class'    => 'MyClass',
    'function' => 'MyMethod',
    'filename' => 'Myclass.php',
    'filepath' => 'hooks',
    'params'   => array('beer', 'wine', 'snacks')
);

$hook['pre_controller'][] = array(
    'class'    => 'MyOtherClass',
    'function' => 'MyOtherMethod',
    'filename' => 'Myotherclass.php',
    'filepath' => 'hooks',
    'params'   => array('red', 'yellow', 'blue')
);

注意数组索引后面多了个中括号:$hook['pre_controller'][]

这可以让你在同一个挂钩点处执行多个脚本，多个脚本执行顺序就是你定义数组的顺序。

 

钩子类分析

  1 /**
  2  * 钩子嘛，就是在不修改系统核心文件的基础上来改变或增加系统的核心运行功能
  3  */
  4 class CI_Hooks {
  5  
  6     /**
  7      * 检测hook是否开启
  8      */
  9     var $enabled        = FALSE;
 10     /**
 11      * config/hooks.php中的hooks配置信息
 12      */
 13     var $hooks            = array();
 14     //防止死循环，因为钩子程序里面可能还还有钩子
 15     var $in_progress    = FALSE;
 16  
 17     //构造函数
 18     function __construct()
 19     {
 20         $this->_initialize();
 21         log_message('debug', "Hooks Class Initialized");
 22     }
 23  
 24     /**
 25      * 初始化，获取hooks配合
 26      */
 27     function _initialize()
 28     {
 29         $CFG =& load_class('Config', 'core');
 30  
 31         // 检测配置是否开启钩子
 32         if ($CFG->item('enable_hooks') == FALSE)
 33         {
 34             return;
 35         }
 36  
 37         // 检测是否配置钩子
 38         if (defined('ENVIRONMENT') AND is_file(APPPATH.'config/'.ENVIRONMENT.'/hooks.php'))
 39         {
 40             include(APPPATH.'config/'.ENVIRONMENT.'/hooks.php');
 41         }
 42         elseif (is_file(APPPATH.'config/hooks.php'))
 43         {
 44             include(APPPATH.'config/hooks.php');
 45         }
 46  
 47  
 48         if ( ! isset($hook) OR ! is_array($hook))
 49         {
 50             return;
 51         }
 52  
 53         $this->hooks =& $hook;
 54         $this->enabled = TRUE;
 55     }
 56  
 57     // --------------------------------------------------------------------
 58  
 59     /**
 60      * 运行钩子程序，外部就是这样调用：
 61          *     $EXT =& load_class('Hooks', 'core');
 62      *      $EXT->_call_hook('pre_system');
 63      */
 64     function _call_hook($which = '')
 65     {
 66         if ( ! $this->enabled OR ! isset($this->hooks[$which]))
 67         {
 68             return FALSE;
 69         }
 70                 //CI支持多次钩子，那么就是二维数组
 71         if (isset($this->hooks[$which][0]) AND is_array($this->hooks[$which][0]))
 72         {
 73             foreach ($this->hooks[$which] as $val)
 74             {
 75                 $this->_run_hook($val);
 76             }
 77         }
 78         else
 79         {
 80                         //一个钩子直接运行钩子
 81             $this->_run_hook($this->hooks[$which]);
 82         }
 83  
 84         return TRUE;
 85     }
 86  
 87     // --------------------------------------------------------------------
 88  
 89     /**
 90      * Run Hook
 91      *
 92      * Runs a particular hook
 93      *
 94      * @access    private
 95      * @param    array    the hook details
 96      * @return    bool
 97      */
 98     function _run_hook($data)
 99     {
100         if ( ! is_array($data))
101         {
102             return FALSE;
103         }
104         
105                 //防止死循环，因为钩子程序里面可能还还有钩子
106         if ($this->in_progress == TRUE)
107         {
108             return;
109         }
110  
111         //设置路径
112                 //下面可以filepathfilepath就以那个文件夹(application)为基准，application/hooks下, 你可以把hooks 作为你的filepath
113                 
114         if ( ! isset($data['filepath']) OR ! isset($data['filename']))
115         {
116             return FALSE;
117         }
118  
119         $filepath = APPPATH.$data['filepath'].'/'.$data['filename'];
120  
121         if ( ! file_exists($filepath))
122         {
123             return FALSE;
124         }
125  
126         // -----------------------------------
127         // Set class/function name
128         // -----------------------------------
129  
130         $class        = FALSE;
131         $function    = FALSE;
132         $params        = '';
133  
134         if (isset($data['class']) AND $data['class'] != '')
135         {
136             $class = $data['class'];
137         }
138  
139         if (isset($data['function']))
140         {
141             $function = $data['function'];
142         }
143  
144         if (isset($data['params']))
145         {
146             $params = $data['params'];
147         }
148  
149         if ($class === FALSE AND $function === FALSE)
150         {
151             return FALSE;
152         }
153  
154         //不用多说了吧
155         $this->in_progress = TRUE;
156  
157         //获取钩子配置信息成功后，运行钩子程序
158         if ($class !== FALSE)
159         {
160             if ( ! class_exists($class))
161             {
162                 require($filepath);
163             }
164  
165             $HOOK = new $class;
166             $HOOK->$function($params);
167         }
168         else
169         {
170             if ( ! function_exists($function))
171             {
172                 require($filepath);
173             }
174  
175             $function($params);
176         }
177                 // //执行相应程序完毕后，重新把当前hook的状态改为非运行中，以让它可以再次被触发。
178         $this->in_progress = FALSE;
179         return TRUE;
180     }
181  
182 }