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

使用CI框架，我们通常使用一下三个函数处理错误：

show_error('消息' [, int $status_code = 500 ] )

show_404('页面' [, 'log_error'])

log_message('级别', '消息')，有一下三种错误信息：

1. 错误类型的消息。 这种是真正的错误消息. 例如PHP错误或者用户错误。 
2. 调试类型的消息。 这种是用来帮助调试的消息。 例如， 如果当一个类被初始化时，你可以将这个初始化纪录下来，然后用于调试。 
3. 信息类型的消息。 这种是最低优先级别的消息，它只是简单的提供了关于运行的一些信息。 CodeIgniter 不会自动产生任何信息类型的消息，但是你可能会在你的程序里使用它  

class CI_Exceptions {
    protected $action;
    protected $severity;
    protected $message;
    protected $filename;
    protected $line;
 
    //嵌套的输出缓冲处理程序的级别；如果输出缓冲区不起作用，返回零。
    protected $ob_level;
 
    //PHP error level
    protected $levels = array(
                E_ERROR                =>    'Error',//致命错误
                E_WARNING            =>    'Warning',//非致命运行错误
                E_PARSE                =>    'Parsing Error',//编译错误
                E_NOTICE            =>    'Notice',//notice错误
                E_CORE_ERROR        =>    'Core Error',//PHP启动时致命错误
                E_CORE_WARNING        =>    'Core Warning',     //PHP启动时非致命错误
                E_COMPILE_ERROR        =>    'Compile Error',//致命的编译错误
                E_COMPILE_WARNING    =>    'Compile Warning',//非致命的编译错误
                E_USER_ERROR        =>    'User Error',//致命的用户生成错误
                E_USER_WARNING        =>    'User Warning',//非致命的用户生成警告
                E_USER_NOTICE        =>    'User Notice',//用户生成的通知
                E_STRICT            =>    'Runtime Notice'//Run-time通知，提高代码稳定可靠性
        );
 
 
    public function __construct()
    {
                //获取嵌套的输出缓冲处理程序的级别
        $this->ob_level = ob_get_level();
    }
 
    // --------------------------------------------------------------------
 
    //记录错误日志
    function log_exception($severity, $message, $filepath, $line)
    {
        $severity = ( ! isset($this->levels[$severity])) ? $severity : $this->levels[$severity];
 
        log_message('error', 'Severity: '.$severity.'  --> '.$message. ' '.$filepath.' '.$line, TRUE);
    }
 
    // --------------------------------------------------------------------
 
    /**
     * 可以看出show_404只是show_error的一种特殊情况
     */
    function show_404($page = '', $log_error = TRUE)
    {
        $heading = "404 Page Not Found";
        $message = "The page you requested was not found.";
 
        // 是否需要记录日志
        if ($log_error)
        {
            log_message('error', '404 Page Not Found --> '.$page);
        }
 
        echo $this->show_error($heading, $message, 'error_404', 404);
        exit;
    }
 
    // --------------------------------------------------------------------
 
    //有意识的触发错误，如找不到控制器等
    function show_error($heading, $message, $template = 'error_general', $status_code = 500)
    {
                //响应一个http头
        set_status_header($status_code);
 
        $message = '<p>'.implode('</p><p>', ( ! is_array($message)) ? array($message) : $message).'</p>';
                /**
                 * 缓冲机制是有嵌套级别的，
                 * 这个if判断是说发生错误的缓冲级别和Exception被加载【刚开始】的缓冲级别相差1以上
                 * 看core/Loader.php中的_ci_load() CI在加载view的时候先ob_start(),然后由output处理输出，
                 *  因此，如果是在视图文件发生错误，则就会出现缓冲级别相差1的情况，此时先把输出的内容给flush出来，然后再把错误信息输出。
                 */
        if (ob_get_level() > $this->ob_level + 1)
        {
            ob_end_flush();
        }
                
                //输出缓冲内容
        ob_start();
        include(APPPATH.'errors/'.$template.'.php');
        $buffer = ob_get_contents();
        ob_end_clean();
        return $buffer;
    }
 
    // --------------------------------------------------------------------
 
    //PHP代码错误
    function show_php_error($severity, $message, $filepath, $line)
    {
        $severity = ( ! isset($this->levels[$severity])) ? $severity : $this->levels[$severity];
 
        $filepath = str_replace("\", "/", $filepath);
 
        // 为了安全起见，只显示最后两段路径
        if (FALSE !== strpos($filepath, '/'))
        {
            $x = explode('/', $filepath);
            $filepath = $x[count($x)-2].'/'.end($x);
        }
                
        if (ob_get_level() > $this->ob_level + 1)
        {       //输出缓冲区内容并关闭缓冲
            ob_end_flush();
        }
        ob_start();
        include(APPPATH.'errors/error_php.php');
        $buffer = ob_get_contents();
        ob_end_clean();
        echo $buffer;
    }
}