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;
     }
 }