set_error_handler与set_exception_handler

Posted 2021-01-23 gotophp

set_error_handler

由于历史原因，php一开始被设计为一门面向过程的语言，所以异常处理没有使用像Java一样的 try / catch 机制，出错时直接显示到页面上，或者记录到web服务器的错误日志中，并且php的错误分成了很多的级别，例如E_ERROR、E_WARNING、E_PARSE、E_NOTICE等等，对于像E_ERROR、E_PARSE这样的严重错误，php会直接终止脚本的运行。

 

虽然对于php5版本，我们可以使用set_error_handler来注册自己的错误处理方法来代替php的标准错误处理方式（输出到页面或者记录到日志），但是一些严重错误是无法通过这种方式来处理的，对于E_ERROR、E_PARSE之类的错误并不能被用户处理，

自定义的错误处理方法

<?php
function _error_handler($errno, $errstr ,$errfile, $errline)
{
echo "错误编号errno: $errno<br>";
echo "错误信息errstr: $errstr<br>";
echo "出错文件errfile: $errfile<br>";
echo "出错行号errline: $errline<br>";
}
// 注册错误处理方法来处理所有错误
set_error_handler(‘_error_handler‘, E_ALL | E_STRICT);
// 由于数组未定义，会产生一个notice级别的错误
echo $foo[‘bar‘]; 

 

运行结果

错误编号errno: 8

错误信息errstr: Undefined variable: foo

出错文件errfile: D:projectdemodemo.php

出错行号errline: 16

 

不能被自定义错误方法处理

<?php
function _error_handler($errno, $errstr ,$errfile, $errline)
{
    echo "错误编号errno: $errno<br>";
    echo "错误信息errstr: $errstr<br>";
    echo "出错文件errfile: $errfile<br>";
    echo "出错行号errline: $errline<br>";
}
// 注册错误处理方法来处理所有错误
set_error_handler(‘_error_handler‘, E_ALL | E_STRICT);
 
// 由于数组未定义，会产生一个notice级别的错误
echo $foo[‘bar‘];
 
//人为触发错误
trigger_error(‘人为触发一个错误‘, E_USER_ERROR);
 
//调用未定义的方法将会产生一个Error级别的错误
foobar(3, 5); 

 

运行结果

错误编号errno: 8

错误信息errstr: Undefined variable: foo

出错文件errfile: D:projectdemodemo.php

出错行号errline: 15

错误编号errno: 256

错误信息errstr:人为产生触发一个错误

出错文件errfile: D:projectdemodemo.php

出错行号errline: 17

Fatal error: Call to undefined function foobar() in D:projectdemodemo.php on line 19

set_error_handler总结

前两个错误被我们“捕获”处理了，而最后的Fatal error并没有按照我们注册的错误函数来处理，还是使用的默认的处理方式，这也是php5版本的错误处理的一大缺陷。PHP7之后的异常处理方式有了一些新的变化

 

PHP7的异常处理方式

PHP 7 改变了大多数错误的报告方式。不同于传统（PHP 5）的错误报告机制，现在大多数错误被作为 Error 异常抛出。

这种 Error 异常可以像 Exception 异常一样被第一个匹配的 try / catch 块所捕获。如果没有匹配的 catch 块，则调用异常处理函数（事先通过 set_exception_handler() 注册）进行处理。

如果尚未注册异常处理函数，则按照传统方式处理：被报告为一个致命错误（Fatal Error）。

Error 类并非继承自 Exception 类，所以不能用 catch (Exception $e) { ... } 来捕获 Error。你可以用 catch (Error $e) { ... }，或者通过注册异常处理函数（ set_exception_handler()）来捕获 Error。

自定义的错误处理方法

<?php
function _error_handler($errno, $errstr ,$errfile, $errline){
    echo "错误编号errno: $errno<br>";
    echo "错误信息errstr: $errstr<br>";
    echo "出错文件errfile: $errfile<br>";
    echo "出错行号errline: $errline<br>";
}
set_error_handler(‘_error_handler‘, E_ALL | E_STRICT); // 注册错误处理方法来处理所有错误
try{
    echo $foo[‘bar‘]; // 由于数组未定义，会产生一个notice级别的错误
    trigger_error(‘人为产生触发一个错误‘, E_USER_ERROR); //人为触发错误
    foobar(3, 5); //调用未定义的方法将会产生一个Error级别的错误
} catch (Error $e) {
    echo "Error code: " . $e->getCode() . ‘<br>‘;
    echo "Error message: " . $e->getMessage() . ‘<br>‘;
    echo "Error file: " . $e->getFile() . ‘<br>‘;
    echo "Error fileline: " . $e->getLine() . ‘<br>‘;
}

 

运行结果

错误编号errno: 8

错误信息errstr: Undefined variable: foo

出错文件errfile: E:projectdemodemo.php

出错行号errline: 17

错误编号errno: 256

错误信息errstr: 人为产生触发一个错误

出错文件errfile: E:projectdemodemo.php

出错行号errline: 19

Error code: 0

Error message: Call to undefined function foobar()

Error file: E:projectdemodemo.php

Error fileline: 21

 

这样不同类型的错误都可以被我们自己处理了，包括致命错误。

这样不同类型的错误都可以被我们自己处理了，包括致命错误。如果不使用 try / catch , php7的报错信息和php5还是有一些不同：

错误编号errno: 8

错误信息errstr: Undefined variable: foo

出错文件errfile: E:projectdemodemo.php

出错行号errline: 17

错误编号errno: 256

错误信息errstr: 人为触发一个错误

出错文件errfile: E:projectdemodemo.php

出错行号errline: 19

Fatal error: Uncaught Error: Call to undefined function foobar() in E:projectdemodemo.php:21 Stack trace: #0 {main} thrown in E:projectdemodemo.php on line 21

 

致命错误的描述变成： 抛出的一个Error没有被捕获。

同时捕获Error与Exception

注意这里的catch限定的只能捕获Error类的错误，并且手册上明确说了 Error类并不是Exception类的子类，如果同时想捕获代码中的Exception错误应该捕获：Throwable，因为Error类和Exception类都是Throwable的子类，实际上是Error类和Exception类都实现了Throwable接口

<?php
//自定义的错误处理方法
function _error_handler($errno, $errstr ,$errfile, $errline){
    echo "错误编号errno: $errno<br>";
    echo "错误信息errstr: $errstr<br>";
    echo "出错文件errfile: $errfile<br>";
    echo "出错行号errline: $errline<br>";
}

// 注册错误处理方法来处理所有错误
set_error_handler(‘_error_handler‘, E_ALL | E_STRICT);

try{
    echo $foo[‘bar‘]; // 由于数组未定义，会产生一个notice级别的错误
    trigger_error(‘人为触发一个错误‘, E_USER_ERROR); //人为触发错误
    if (mt_rand(1, 10) > 5){
        //抛出一个Exception,看是否可以被catch
        throw new Exception(‘This is a exception‘, 400);
    }else{
        //调用未定义的方法将会产生一个Error级别的错误
        foobar(3, 5); 
    }
}catch (Throwable $e){
    echo "Error code: " . $e->getCode() . ‘<br>‘;
    echo "Error message: " . $e->getMessage() . ‘<br>‘;
    echo "Error file: " . $e->getFile() . ‘<br>‘;
    echo "Error fileline: " . $e->getLine() . ‘<br>‘;
}                

 

set_exception_handler

如果不想所有的错误都用 try / catch 处理，还可以使用set_exception_handler注册异常处理函数，这样当有未被catch的异常产生时，系统会为我们自动调用注册的处理函数来处理。

代码

function _exception_handler(Throwable $e){
    if ($e instanceof Error){
        echo "catch Error: " . $e->getCode() . ‘ ‘ . $e->getMessage() . ‘<br>‘;
    }else{
        echo "catch Exception: " . $e->getCode() . ‘ ‘ . $e->getMessage() . ‘<br>‘;
    }
}    

 

set_error_handler与set_exception_handler

这时我们可能又会被PHP7弄晕，哪些被set_error_handler处理，哪些被set_exception_handler处理，手册上也没有明确说明这块，根据我的总结，大致上不会导致脚本终止运行的错误会被set_error_handler处理，而会终止脚本运行的严重错误会被当作Error抛出，但不是绝对，上面人为触发的

 

E_USER_ERROR就是一个会打断脚本运行的错误，但是并没有当作Error异常抛出，而是交由set_error_handler注册的方法处理，这可能是因为这类错误是我们自己人为产生的有关，所以PHP7的错误处理还是有一些含糊不清，对于我们自己处理时要多加小心。