首页
所有分类
TAGS
文字工具 EMOJI BIBLE
编程 PHP

PHP各种异常和错误的拦截方法及发生致命错误时进行报警

Posted in PHP onJanuary 19, 2016

在日常开发中，大多数人的做法是在开发环境时开启调试模式，在产品环境关闭调试模式。在开发的时候可以查看各种错误、异常，但是在线上就把错误显示的关闭。

上面的情形看似很科学，有人解释为这样很安全，别人看不到错误，以免泄露重要信息...

但是你有没有遇到这种情况，线下好好的，一上线却运行不起来也找不到原因...

一个脚本，跑了好长一段时间，一直没有问题，有一天突然中断了，然后了也没有任何记录都不造啥原因...

线上一个付款，别人明明付了款，但是我们却没有记录到，自己亲自去实验，却是好的...

种种以上，都是因为大家关闭了错误信息，并且未将错误、异常记录到日志，导致那些随机发生的错误很难追踪。这样矛盾就来了，即不要显示错误，又要追踪错误，这如何实现了？

以上问题都可以通过PHP的错误、异常机制及其内建函数'set_exception_handler','set_error_handler','register_shutdown_function' 来实现

'set_exception_handler' 函数 用于拦截各种未捕获的异常，然后将这些交给用户自定义的方式进行处理

'set_error_handler' 函数可以拦截各种错误，然后交给用户自定义的方式进行处理

'register_shutdown_function' 函数是在PHP脚本结束时调用的函数，配合'error_get_last'可以获取最后的致命性错误

这个思路大体就是把错误、异常、致命性错误拦截下来，交给我们自定义的方法进行处理，我们辨别这些错误、异常是否致命，如果是则记录的数据库或者文件系统，然后使用脚本不停的扫描这些日志，发现严重错误立即发送邮件或发送短信进行报警

首先我们定义错误拦截类，该类用于将错误、异常拦截下来，用我们自己定义的处理方式进行处理，该类放在文件名为'errorHandler.class.php'中，代码如下

/**
 * 文件名称：baseErrorHandler.class.php
 * 摘 要：错误拦截器父类
 */
require 'errorHandlerException.class.php';//异常类
class errorHandler
{
 public $argvs = array();
 public  $memoryReserveSize = 262144;//备用内存大小
 private $_memoryReserve;//备用内存
 /**
  * 方  法：注册自定义错误、异常拦截器
  * 参  数：void
  * 返  回：void
  */
 public function register()
 {
  ini_set('display_errors', 0);
  set_exception_handler(array($this, 'handleException'));//截获未捕获的异常
  set_error_handler(array($this, 'handleError'));//截获各种错误 此处切不可掉换位置
  //留下备用内存 供后面拦截致命错误使用
  $this->memoryReserveSize > 0 && $this->_memoryReserve = str_repeat('x', $this->memoryReserveSize);
  register_shutdown_function(array($this, 'handleFatalError'));//截获致命性错误
 }
 /**
  * 方  法：取消自定义错误、异常拦截器
  * 参  数：void
  * 返  回：void
  */
 public function unregister()
 {
  restore_error_handler();
  restore_exception_handler();
 }
 /**
  * 方  法：处理截获的未捕获的异常
  * 参  数：Exception $exception
  * 返  回：void
  */
 public function handleException($exception)
 {
  $this->unregister();
  try
  {
   $this->logException($exception);
   exit(1);
  }
  catch(Exception $e)
  {
   exit(1);
  }
 }
 /**
  * 方  法：处理截获的错误
  * 参  数：int  $code 错误代码
  * 参  数：string $message 错误信息
  * 参  数：string $file 错误文件
  * 参  数：int  $line 错误的行数
  * 返  回：boolean
  */
 public function handleError($code, $message, $file, $line)
 {
  //该处思想是将错误变成异常抛出 统一交给异常处理函数进行处理
  if((error_reporting() & $code) && !in_array($code, array(E_NOTICE, E_WARNING, E_USER_NOTICE, E_USER_WARNING, E_DEPRECATED)))
  {//此处只记录严重的错误 对于各种WARNING NOTICE不作处理
   $exception = new errorHandlerException($message, $code, $code, $file, $line);
   $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
   array_shift($trace);//trace的第一个元素为当前对象 移除
   foreach($trace as $frame) 
   {
    if($frame['function'] == '__toString') 
    {//如果错误出现在 __toString 方法中 不抛出任何异常
     $this->handleException($exception);
     exit(1);
    }
   }
   throw $exception;
  }
  return false;
 }
 /**
  * 方  法：截获致命性错误
  * 参  数：void
  * 返  回：void
  */
 public function handleFatalError()
 {
  unset($this->_memoryReserve);//释放内存供下面处理程序使用
  $error = error_get_last();//最后一条错误信息
  if(errorHandlerException::isFatalError($error))
  {//如果是致命错误进行处理
   $exception = new errorHandlerException($error['message'], $error['type'], $error['type'], $error['file'], $error['line']);
   $this->logException($exception);
   exit(1);
  }
 }
 /**
  * 方  法：获取服务器IP
  * 参  数：void
  * 返  回：string
  */
 final public function getServerIp()
 {
  $serverIp = '';
  if(isset($_SERVER['SERVER_ADDR']))
  {
   $serverIp = $_SERVER['SERVER_ADDR'];
  }
  elseif(isset($_SERVER['LOCAL_ADDR']))
  {
   $serverIp = $_SERVER['LOCAL_ADDR'];
  }
  elseif(isset($_SERVER['HOSTNAME']))
  {
   $serverIp = gethostbyname($_SERVER['HOSTNAME']);
  }
  else
  {
   $serverIp = getenv('SERVER_ADDR');
  }  
  return $serverIp; 
 }
 /**
  * 方  法：获取当前URI信息
  * 参  数：void
  * 返  回：string $url
  */
 public function getCurrentUri()
 {
  $uri = '';
  if($_SERVER ["REMOTE_ADDR"])
  {//浏览器浏览模式
   $uri = 'http://' . $_SERVER['SERVER_NAME'] . $_SERVER['REQUEST_URI'];
  }
  else
  {//命令行模式
   $params = $this->argvs;
   $uri = $params[0];
   array_shift($params);
   for($i = 0, $len = count($params); $i < $len; $i++)
   {
    $uri .= ' ' . $params[$i];
   }
  }
  return $uri;
 }
 /**
  * 方  法：记录异常信息
  * 参  数：errorHandlerException $e 错误异常
  * 返  回：boolean 是否保存成功
  */
 final public function logException($e)
 {
  $error = array(
      'add_time'  =>  time(),
      'title'  =>  errorHandlerException::getName($e->getCode()),//这里获取用户友好型名称
      'message'  =>  array(),
      'server_ip' =>  $this->getServerIp(),
      'code'   =>  errorHandlerException::getLocalCode($e->getCode()),//这里为各种错误定义一个编号以便查找
      'file'   => $e->getFile(),
      'line'   =>  $e->getLine(),
      'url'  => $this->getCurrentUri(),
     );
  do
  {
   //$e->getFile() . ':' . $e->getLine() . ' ' . $e->getMessage() . '(' . $e->getCode() . ')'
   $message = (string)$e;
   $error['message'][] = $message;
  } while($e = $e->getPrevious());
  $error['message'] = implode("\r\n", $error['message']);
  $this->logError($error);
 }
 /**
  * 方  法：记录异常信息
  * 参  数：array $error = array(
  *         'time' => int, 
  *         'title' => 'string', 
  *         'message' => 'string', 
  *         'code' => int,
  *         'server_ip' => 'string'
  *          'file'  => 'string',
  *         'line' => int,
  *         'url' => 'string',
  *        );
  * 返  回：boolean 是否保存成功
  */
 public function logError($error)
 {
  /*这里去实现如何将错误信息记录到日志*/
 }
}

上述代码中，有个'errorHandlerException'类，该类放在文件'errorHandlerException.class.php'中，该类用于将错误转换为异常，以便记录错误发生的文件、行号、错误代码、错误信息等信息，同时其方法'isFatalError'用于辨别该错误是否是致命性错误。这里我们为了方便管理，将错误进行编号并命名。该类的代码如下

/**
 * 文件名称：errorHandlerException.class.php
 * 摘 要：自定义错误异常类 该类继承至PHP内置的错误异常类
 */
class errorHandlerException extends ErrorException
{
 public static $localCode = array(
          E_COMPILE_ERROR => 4001,
          E_COMPILE_WARNING => 4002,
          E_CORE_ERROR => 4003,
          E_CORE_WARNING => 4004,
          E_DEPRECATED => 4005,
          E_ERROR => 4006,
          E_NOTICE => 4007,
          E_PARSE => 4008,
          E_RECOVERABLE_ERROR => 4009,
          E_STRICT => 4010,
          E_USER_DEPRECATED => 4011,
          E_USER_ERROR => 4012,
          E_USER_NOTICE => 4013,
          E_USER_WARNING => 4014,
          E_WARNING => 4015,
          4016 => 4016,
         );
 public static $localName = array(
          E_COMPILE_ERROR => 'PHP Compile Error',
          E_COMPILE_WARNING => 'PHP Compile Warning',
          E_CORE_ERROR => 'PHP Core Error',
          E_CORE_WARNING => 'PHP Core Warning',
          E_DEPRECATED => 'PHP Deprecated Warning',
          E_ERROR => 'PHP Fatal Error',
          E_NOTICE => 'PHP Notice',
          E_PARSE => 'PHP Parse Error',
          E_RECOVERABLE_ERROR => 'PHP Recoverable Error',
          E_STRICT => 'PHP Strict Warning',
          E_USER_DEPRECATED => 'PHP User Deprecated Warning',
          E_USER_ERROR => 'PHP User Error',
          E_USER_NOTICE => 'PHP User Notice',
          E_USER_WARNING => 'PHP User Warning',
          E_WARNING => 'PHP Warning',
          4016 => 'Customer`s Error',
         );
 /**
  * 方  法：构造函数
  * 摘  要：相关知识请查看 http://php.net/manual/en/errorexception.construct.php
  * 
  * 参  数：string  $message  异常信息(可选)
  *    int   $code   异常代码(可选)
  *    int   $severity
  *    string  $filename  异常文件(可选)
  *    int   $line   异常的行数(可选)
  *   Exception $previous 上一个异常(可选)
  *
  * 返  回：void
  */
 public function __construct($message = '', $code = 0, $severity = 1, $filename = __FILE__, $line = __LINE__, Exception $previous = null)
 {
  parent::__construct($message, $code, $severity, $filename, $line, $previous);
 }
 /**
  * 方  法：是否是致命性错误
  * 参  数：array $error
  * 返  回：boolean
  */
 public static function isFatalError($error)
 {
  $fatalErrors = array(
        E_ERROR, 
        E_PARSE, 
        E_CORE_ERROR,
        E_CORE_WARNING, 
        E_COMPILE_ERROR, 
        E_COMPILE_WARNING
       );
  return isset($error['type']) && in_array($error['type'], $fatalErrors);
 }
 /**
  * 方  法：根据原始的错误代码得到本地的错误代码
  * 参  数：int $code
  * 返  回：int $localCode
  */
 public static function getLocalCode($code)
 {
  return isset(self::$localCode[$code]) ? self::$localCode[$code] : self::$localCode[4016];
 }
 /**
  * 方  法：根据原始的错误代码获取用户友好型名称
  * 参  数：int 
  * 返  回：string $name
  */
 public static function getName($code)
 {
  return isset(self::$localName[$code]) ? self::$localName[$code] : self::$localName[4016];
 }

在错误拦截类中，需要用户自己定义实现错误记录的方法('logException')，这个地方需要注意，有些错误可能在一段时间内不断发生，因此只需记录一次即可，你可以使用错误代码、文件、行号、错误详情 生成一个MD5值用于记录该错误是否已经被记录，如果在规定时间内（一个小时）已经被记录过则不需要再进行记录

然后我们定义一个文件，用于实例化以上类，捕获各种错误、异常，该文件命名为'registerErrorHandler.php'， 内如如下

/*
* 使用方法介绍：
* 在入口处引入该文件即可，然后可以在该文件中定义调试模式常量'DEBUG_ERROR'
*
* <?php
* 
* require 'registerErrorHandler.php';
* 
* ?>
*/
/**
* 调试错误模式:
* 0    =>   非调试模式，不显示异常、错误信息但记录异常、错误信息
* 1    =>   调试模式，显示异常、错误信息但不记录异常、错误信息
*/
define('DEBUG_ERROR', 0);
require 'errorHandler.class.php';
class registerErrorHandler
{
 /**
  * 方  法：注册异常、错误拦截
  * 参  数：void
  * 返  回：void
  */
 public static function register()
 {
  global $argv;
  if(DEBUG_ERROR)
  {//如果开启调试模式
   ini_set('display_errors', 1);
   return;
  }
  //如果不开启调试模式
  ini_set('error_reporting', -1);
  ini_set('display_errors', 0);
  $handler = new errorHandler();
  $handler->argvs = $argv;//此处主要兼容命令行模式下获取参数
  $handler->register();
 } 
}
registerErrorHandler::register();

剩下的就是需要你在你的入口文件引入该文件，定义调试模式，然后实现你自己记录错误的方法即可

需要注意的是，有些错误在你进行注册之前已经发生并且导致脚本中断是无法记录下来的，因为此时'registerErrorHandler::register()' 尚未执行已经中断了

还有就是'set_error_handler'这个函数不能捕获下面类型的错误 E_ERROR、 E_PARSE、 E_CORE_ERROR、 E_CORE_WARNING、E_COMPILE_ERROR、 E_COMPILE_WARNING, 这个可以在官方文档中看到，但是本处无妨，因为以上错误是解析、编译错误，这些都没有通过，你是不可能发布上线的

PHP各种异常和错误的拦截方法及发生致命错误时进行报警

- Author -

八面碰壁居士

声明：登载此文出于传递更多信息之目的，并不意味着赞同其观点或证实其描述。

PHP 相关文章推荐
MVC模式的PHP实现
Oct 09 PHP
一个简单的PHP&amp;MYSQL留言板源码
Jul 19 PHP
php中截取中文字符串的代码小结
Jul 17 PHP
PHP序列号生成函数和字符串替换函数代码
Jun 07 PHP
php如何解决无法上传大于8M的文件问题
Mar 10 PHP
PHP实现简单数字分页效果
Jul 26 PHP
smarty中改进truncate使其支持中文的方法
May 30 PHP
PHP中加速、缓存扩展的区别和作用详解(eAccelerator、memcached、xcache、APC )
Jul 09 PHP
php加密解密字符串示例
Oct 13 PHP
PHP实现导出excel数据的类库用法示例
Oct 15 PHP
基于jQueryUI和Corethink实现百度的搜索提示功能
Nov 09 PHP
PHP命名空间用法实例分析
Sep 04 PHP
[原创]CI(CodeIgniter)简单统计访问人数实现方法
Jan 19 #PHP
PHP数组去重比较快的实现方式
Jan 19 #PHP
PHP保存session到memcache服务器的方法
Jan 19 #PHP
PHP mysql事务问题实例分析
Jan 18 #PHP
给PHP开发者的编程指南 第一部分降低复杂程度
Jan 18 #PHP
PHP基于cookie与session统计网站访问量并输出显示的方法
Jan 15 #PHP
php实现的操作excel类详解
Jan 15 #PHP
高动态范围(1) Vue3(1) 数据加密(1) pycryto(1) shell脚本(1) 曝光融合(1) kafka(2) axios(1) HDR(1) 连接器(1)
You might like
《魔兽世界》惊魂幻象将获得调整
2020/03/08 其他游戏
一个捕获函数输出的函数
2007/02/14 PHP
php上传文件,创建递归目录的实例代码
2013/10/18 PHP
php 批量添加多行文本框textarea一行一个
2014/06/03 PHP
php+mysql实现用户注册登陆的方法
2015/01/03 PHP
Javascript技术技巧大全（五）
2007/01/22 Javascript
jquery ajax 检测用户注册时用户名是否存在
2009/11/03 Javascript
解决css和js的{}与smarty定界符冲突问题的两种方法
2013/09/10 Javascript
js 中的switch表达式使用示例
2020/06/03 Javascript
jQuery中wrapAll()方法用法实例
2015/01/16 Javascript
jQuery菜单插件superfish使用指南
2015/04/21 Javascript
JS面向对象编程详解
2016/03/06 Javascript
使用jQuery制作浮动工具栏的实例分享
2016/05/13 Javascript
Chrome浏览器的alert弹窗禁止再次弹出后恢复的方法
2016/12/30 Javascript
深入理解Vuex 模块化(module)
2017/09/26 Javascript
Angular4集成ng2-file-upload的上传组件
2018/03/14 Javascript
angularjs性能优化的方法
2018/09/05 Javascript
将RGB值转换为灰度值的简单算法
2019/10/09 Javascript
Python实现二叉树结构与进行二叉树遍历的方法详解
2016/05/24 Python
python 开发的三种运行模式详细介绍
2017/01/18 Python
Python处理文本文件中控制字符的方法
2017/02/07 Python
python用pickle模块实现“增删改查”的简易功能
2017/06/07 Python
使用pytorch进行图像的顺序读取方法
2018/07/27 Python
如何在python中执行另一个py文件
2020/04/30 Python
python 爬虫请求模块requests详解
2020/12/04 Python
英国领先的电动可调床制造商：Laybrook
2019/12/26 全球购物
同事吵架检讨书
2014/02/05 职场文书
平安家庭示范户事迹
2014/06/02 职场文书
商业企业管理专业求职信
2014/07/10 职场文书
社区四风存在问题及整改措施
2014/10/26 职场文书
横店影视城导游词
2015/02/06 职场文书
坎儿井导游词
2015/02/09 职场文书
六一文艺汇演主持词
2015/06/30 职场文书
廉政党课工作报告案例
2019/06/21 职场文书
浅析InnoDB索引结构
2021/04/05 MySQL
Navicat Premium自定义 sql 标签的创建方式
2022/09/23 数据库