关于PHP自动捕捉处理错误和异常的尝试

  之所以想着做错误和异常的自动处理是因为:

    用的公司自己的框架写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;
        }
    }
}

 

 

posted @ 2019-03-21 17:40  _Eternity味道  Views(1754)  Comments(0Edit  收藏  举报