之所以想着做错误和异常的自动处理是因为:
用的公司自己的框架写API,没有异常和错误相关功能,
而每次操作都进行try...catch,有点繁琐不说,感觉还很鸡肋,即使我catch到了,还是得写代码进行处理,哪怕封装了一个方法进行处理也还是繁琐,
这种情况应该是程序自动进行处理,不该是这样弱智的人工try...catch,然后处理
以及其他同事写代码时并不能严格的进行try...catch
于是乎,想自己设计一个自动捕获并处理错误和异常的功能。
发现了一篇深度好文:https://www.cnblogs.com/zyf-zhaoyafei/p/6928149.html
理解了PHP中自带的 register_shutdown_function,set_error_handler,set_exception_handler这三个函数
通过这三个函数我们可以实现PHP假 自动捕获异常和错误。PHP5也不支持ERROR的捕获,只能try...catch (Exception)
三个函数必须理解,如果你想实现该功能,希望你可以先做个小demo体验下三个函数的神奇之处
这三个函数需要你写在框架的生命周期比较靠前的地方,如果不知道写哪里,请写在入口文件中,或者在入口文件require一下(下面的源码可以直接require使用)
因为如果写到其他文件中,而碰巧该文件有错误或者异常,那么这三个函数就不发生作用了,而入口文件我们都可以确保正确
正文:
首先介绍set_error_handler这个函数,这个函数用于捕获低级别的错误,该函数只能捕获系统产生的一些Warning、Notice级别的错误,并调用一个用户自定义的错误处理函数。
比如在入口文件写入 set_error_handler('low_level_error'),并且我们建立了low_level_error 自定义方法来进行日志的记录 。
当发生Warning、Notice级别的错误时,系统会自动调用low_level_error方法,四个参数"type"、 "message"、"file" 和 "line"也是系统传过来的,可以直接使用。
注意:使用此函数后 error_reporting ( E_ALL ) 无法提示warning和notice级别的警告, 如果本地开发,最好关闭此函数,在生产环境才使用; 使用 其它两个函数 时错误提示信息不受影响
可以使用下面源码中的单个方法进行测试, 只需echo $str; exit; 就好
第二个函数 register_shutdown_function, 这个函数与第一个函数搭配使用,可以捕捉到Fatal Error、Parse Error等高级别会让程序中止的错误,
这个方法是PHP脚本执行结束前最后一个调用的函数,比如脚本错误、die()、exit、异常、正常结束都会调用。这个方法没有接受参数,所以需要借助error_get_last() ,error_get_last函数可以获取到
系统最近发生的一个错误,同样包含 "type"、 "message"、"file" 和 "line"四个字段,需要注意的是 本函数捕捉到的 (2,8,32,128,512,1024,2048,8192)等错误都是警告级别的,自己酌情处理。
第三个函数set_exception_handler, 这个函数可以捕获 没有用try/catch块来捕获的异常,并且在回调函数调用后异常会中止(这个我没有试,因为我捕捉异常后直接返回给前端错误code码了)。
思路:通过set_error_handler 和 register_shutdown_function 两个函数可以捕捉到所有的错误,通过set_exception_handler 捕捉所有未处理的异常,这样程序中所有的错误和异常就被我们捕捉到了,
接下来,我们可以通过自定义函数对它们进行操作,由于我的业务是直接向前端输出,因此只是记录相关日志后直接echo并退出,大家可以在自定义函数内自己决定做什么处理。
还可以在两个自定义的错误处理函数中再抛出异常,由自定义的异常处理类统一处理,这也是一个不错的思路,大家可以尝试下。
最后:
下面是相关的代码,供大家参考和测试。
<?php
/**引入本文件后,PHP会自动处理错误和异常, php版本5.6, php7+版本需要小调整,运行时根据提示调整即可
* 本方法直接捕捉错误并记录日志,如有兴趣,可以捕捉到错误后再次抛出异常,将错误转为异常后,由set_exception_handler统一进行处理
* User: LiZheng 271648298@qq.com
* Date: 2019/3/21
*/
register_shutdown_function('high_level_error'); //使用了register_shutdown_function 后,当程序遇见一些致命错误时会自动调用函数 high_level_error
set_error_handler('low_level_error'); //使用了set_error_handler 后,当程序遇见Notice 和Warning错误时会自动调用函数 low_level_error
set_exception_handler('exception_log'); //使用了set_exception_handler后,当遇到所有的未捕获的异常时会自动调用函数 exception_log
/**
* 该方法只能捕获系统产生的一些Warning、Notice级别的错误
* @param $type
* @param $message
* @param $file
* @param $line
* User: LiZheng 271648298@qq.com
* Date: 2019/3/21
*/
function low_level_error($type, $message, $file, $line)
{
$time = date('Y-m-d H:i:s');
//拼接要记录成日志的信息
$str = "\n ".$time.' set_error_handler: ' . exception_self::get_type($type) . ':' . $message . ' in ' . $file . ' on ' . $line . ' line .';
$str = addslashes($str);
//记录日志 error_log是PHP自带函数,记录到指定位置,详情见官网
error_log($str,3,ROOT_DIR."/runtime/logs/php_error.log"); //ROOT_DIR为项目根目录
//对于notice和warning 级别的错误,只进行记录而不会终止程序(但在本地开发时希望提示,可以通过if语句判断)
//echo json_encode(array('code'=>“ERR_ERROR”, 'msg'=>$time, 'data'=>array()), true);exit;
}
/**
* 捕捉一些致命错误
* User: LiZheng 271648298@qq.com
* Date: 2019/3/21
*/
function high_level_error()
{
//error_get_last() 获取最近一条发生的错误,包含"type"、 "message"、"file" 和 "line"
if ($error = error_get_last()) {
$time = date('Y-m-d H:i:s');
//拼接要记录成日志的信息
$str = "\n ".$time.' register_shutdown_function: Type:' . exception_self::get_type($error['type']) . ' Msg: ' . $error['message'] . ' in ' . $error['file'] . ' on line ' . $error['line'];
$str = addslashes($str);
//记录日志 error_log是PHP自带函数,记录到指定位置,还可以发送邮件以及其他操作
error_log($str,3,ROOT_DIR."/runtime/logs/php_error.log"); //ROOT_DIR为项目根目录
//直接输出接口的返回信息, 给前端一个错误码code, msg返回时间用于方便查找日志
//echo json_encode(array('code'=>“ERR_ERROR”, 'msg'=>$time, 'data'=>array()), true);exit;
if(in_array($error['type'], array(2,8,32,128,512,1024,2048,8192)))//本条件中的错误均为非致命错误, 8192 错误是弃用提示
{
// if(APP_ENV == 'LOCAL') //这里可以对本地开发环境时进行不同的处理
// {
// header('Content-Type: text/html; charset=utf-8');
// echo $str."\n";
// }
}else
{
// if(APP_ENV == 'LOCAL')
// {
// header('Content-Type: text/html; charset=utf-8');
// echo $str."\n";
// }
//直接输出接口的返回信息, 给前端一个错误码code, msg返回时间用于方便查找日志
echo json_encode(array('code'=>ERR_ERROR, 'msg'=>$time, 'data'=>array()), true);exit;
}
}
}
/**
* 捕捉异常
* @param $exception
* User: LiZheng 271648298@qq.com
* Date: 2019/3/21
*/
function exception_log($exception)
{
$time = date('Y-m-d H:i:s');
//拼接要记录成日志的信息
$str = "\n ".$time." set_exception_handler: Exception: ". $exception->getMessage()." in ".$exception->getFile()." on line ". $exception->getLine();
$str = addslashes($str);
//记录日志
error_log($str,3,ROOT_DIR."/runtime/logs/php_error.log");
//输出信息
echo json_encode(array('code'=>“ERR_EXCEPTION”, 'msg'=>$time, 'data'=>array()), true);exit;
}
/**
* Class error_handler
* Create on 2019/3/21 14:15
* User: LiZheng 271648298@qq.com
* Date: 2019/3/21
*/
class exception_self extends Exception
{
/**
* 构造函数
* @param string $message
* @param string $code
*/
public function __construct($message=null, $code=null)
{
parent::__construct($message, $code);
// self::log($this->__toString());
}
//PHP的错误级别
public static $type = array(
'1' => 'E_ERROR ',
'2' => 'E_WARNING ',
'4' => 'E_PARSE ',
'8' => 'E_NOTICE ',
'16' => 'E_CORE_ERROR ',
'32' => 'E_CORE_WARNING ',
'64' => 'E_COMPILE_ERROR ',
'128' => 'E_COMPILE_WARNING ',
'256' => 'E_USER_ERROR ',
'512' => 'E_USER_WARNING ',
'1024' => 'E_USER_NOTICE ',
'2048' => 'E_STRICT ',
'4096' => 'E_RECOVERABLE_ERROR ',
'8191' => 'E_ALL ',
);
/**
* 通过数字 置换 对应的英文
* @param $key
* @return mixed
* User: LiZheng 271648298@qq.com
* Date: 2019/3/21
*/
public static function get_type($key)
{
if(isset(self::$type[$key]))
{
return self::$type[$key];
}else
{
return $key;
}
}
}
|