CI框架源码完全分析之核心文件(钩子)Hooks.php

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
  在最终着色页面发送到浏览器之后,浏览器接收完最终数据的系统执行末尾调用

钩子的配置很简单：

 $hook['pre_controller'] = array(
    'class'    => 'TestHook', //调用的类名
    'function' => 'test', //调用的函数名
    'filename' => 'TestHook.php', //文件名
    'filepath' => 'hooks', //文件或脚本路径，以application为基准
    'params'   => 'array()'//传递给脚本参数，可选
                                );

用二维数组还可以对同一个挂载点多次引用！

/**
 * 钩子嘛，就是在不修改系统核心文件的基础上来改变或增加系统的核心运行功能
 */
class CI_Hooks {

    /**
     * 检测hook是否开启
     */
    var $enabled       = FALSE;
    /**
     * config/hooks.php中的hooks配置信息
     */
    var $hooks         = array();
    //防止死循环，因为钩子程序里面可能还还有钩子
    var $in_progress   = FALSE;

    //构造函数
    function __construct()
    {
        $this->_initialize();
        log_message('debug', "Hooks Class Initialized");
    }

    /**
     * 初始化，获取hooks配合
     */
    function _initialize()
    {
        $CFG =& load_class('Config', 'core');

        // 检测配置是否开启钩子
        if ($CFG->item('enable_hooks') == FALSE)
        {
            return;
        }

        // 检测是否配置钩子
        if (defined('ENVIRONMENT') AND is_file(APPPATH.'config/'.ENVIRONMENT.'/hooks.php'))
        {
            include(APPPATH.'config/'.ENVIRONMENT.'/hooks.php');
        }
        elseif (is_file(APPPATH.'config/hooks.php'))
        {
            include(APPPATH.'config/hooks.php');
        }


        if ( ! isset($hook) OR ! is_array($hook))
        {
            return;
        }

        $this->hooks =& $hook;
        $this->enabled = TRUE;
    }

    // --------------------------------------------------------------------

    /**
     * 运行钩子程序，外部就是这样调用：
         *  $EXT =& load_class('Hooks', 'core');
     *      $EXT->_call_hook('pre_system');
     */
    function _call_hook($which = '')
    {
        if ( ! $this->enabled OR ! isset($this->hooks[$which]))
        {
            return FALSE;
        }
                //CI支持多次钩子，那么就是二维数组
        if (isset($this->hooks[$which][0]) AND is_array($this->hooks[$which][0]))
        {
            foreach ($this->hooks[$which] as $val)
            {
                $this->_run_hook($val);
            }
        }
        else
        {
                        //一个钩子直接运行钩子
            $this->_run_hook($this->hooks[$which]);
        }

        return TRUE;
    }

    // --------------------------------------------------------------------

    /**
     * Run Hook
     *
     * Runs a particular hook
     *
     * @access  private
     * @param   array   the hook details
     * @return  bool
     */
    function _run_hook($data)
    {
        if ( ! is_array($data))
        {
            return FALSE;
        }

                //防止死循环，因为钩子程序里面可能还还有钩子
        if ($this->in_progress == TRUE)
        {
            return;
        }

        //设置路径
                //下面可以filepathfilepath就以那个文件夹(application)为基准，application/hooks下, 你可以把hooks 作为你的filepath

        if ( ! isset($data['filepath']) OR ! isset($data['filename']))
        {
            return FALSE;
        }

        $filepath = APPPATH.$data['filepath'].'/'.$data['filename'];

        if ( ! file_exists($filepath))
        {
            return FALSE;
        }

        // -----------------------------------
        // Set class/function name
        // -----------------------------------

        $class     = FALSE;
        $function  = FALSE;
        $params        = '';

        if (isset($data['class']) AND $data['class'] != '')
        {
            $class = $data['class'];
        }

        if (isset($data['function']))
        {
            $function = $data['function'];
        }

        if (isset($data['params']))
        {
            $params = $data['params'];
        }

        if ($class === FALSE AND $function === FALSE)
        {
            return FALSE;
        }

        //不用多说了吧
        $this->in_progress = TRUE;

        //获取钩子配置信息成功后，运行钩子程序
        if ($class !== FALSE)
        {
            if ( ! class_exists($class))
            {
                require($filepath);
            }

            $HOOK = new $class;
            $HOOK->$function($params);
        }
        else
        {
            if ( ! function_exists($function))
            {
                require($filepath);
            }

            $function($params);
        }
                // //执行相应程序完毕后，重新把当前hook的状态改为非运行中，以让它可以再次被触发。
        $this->in_progress = FALSE;
        return TRUE;
    }

}

转载注明地址: http://www.phpddt.com/php/ci-hooks.html 尊重他人劳动成果就是尊重自己!