PHP 自动捕获 Fatal Error

最新推荐文章于 2025-11-14 19:46:31 发布

原创最新推荐文章于 2025-11-14 19:46:31 发布 · 1.2k 阅读

0 ·

CC 4.0 BY-SA版权

PHP 专栏收录该内容

25 篇文章

订阅专栏

本文详细介绍PHP中如何使用set_error_handler和set_exception_handler捕获警告、错误和异常，包括如何处理Notice级别错误及致命错误(Fatal Error)，并提供代码示例说明register_shutdown_function和error_get_last的使用技巧。

PHP 有捕获 Error 和 Exception 的函数

设置一个用户的函数来处理脚本中出现的错误。

set_error_handler($callback)

//设置一个用户的函数来处理脚本中出现的异常。

set_exception_handler($callback)

测试异常捕获

<?php
//设置异常捕获函数
set_exception_handler("my_exception");
function my_exception($exception){
    echo 'Exception Catched:'.$exception->getMessage();
}
//抛出异常
throw new Exception("I am Exception");

测试错误捕获

<?php
set_error_handler("error_handler");
function error_handler($errno,$errstr,$errfile,$errline){
    $str=<<<EOF
         "errno":$errno
         "errstr":$errstr
         "errfile":$errfile
         "errline":$errline
EOF;
//获取到错误可以自己处理，比如记 Log、报警等等
    echo $str;
}
echo $test;//$test 未定义，会报一个 notice 级别的错误

不错，Notice 级别的错误也捕获到了！接下来再测一下 Fatal Error.

<?php
set_error_handler("error_handler");
function error_handler($errno,$errstr,$errfile,$errline){
    $str=<<<EOF
         "errno":$errno
         "errstr":$errstr
         "errfile":$errfile
         "errline":$errline
EOF;
//获取到错误可以自己处理，比如记 Log、报警等等
    echo $str;
}
//调用一个不存在的函数，会出现 Fatal Error
test();

Fatal Error 竟然没捕获到

以下级别的错误不能由用户定义的函数来处理：E_ERROR、E_PARSE、E_CORE_ERROR、E_CORE_WARNING、E_COMPILE_ERROR、E_COMPILE_WARNING，和在调用 set_error_handler() 函数所在文件中产生的大多数 E_STRICT。

也就是：set_error_handler($callback)只能捕获系统产生的一些 Warning、Notice 级别的 Error。

要实现这个需求，需要用到两个函数:register_shutdown_function()和error_get_last()。

register_shutdown_function()

register_shutdown_function($callback)

register_shutdown_function()，就把你要注册进去的 function 放进 [假装是队列吧] ，等到脚本正常退出或显式调用 exit()时，再把注册进去的 function 拉出来执行.

register_shutdown_function()调用的 3 种情况：

脚本正常退出时；
在脚本运行(run-time not parse-time)出错退出时；
用户调用 exit 方法退出时。

error_get_last()

error_get_last();//函数获取最后发生的错误。
该函数以数组的形式返回最后发生的错误。

返回的数组包含 4 个键和值： [type] - 错误类型 [message] - 错误消息 [file] - 发生错误所在的文件 [line] - 发生错误所在的行

强烈注意

在 parse-time 出错的时候，是不会调用 register_shutdown_function()函数的。只有在 run-time 出错的时候，才会调用 register_shutdown_function()。

为了更好的理解，下面我们举例说明：

1.error_handler.php

<?php
register_shutdown_function("error_handler");
function error_handler(){
    echo "Yeah,it's worked!";
}
function test(){}
function test(){}

原因分析
在执行 error_handler.php 的时候，由于重复定义了两个函数 test(),在 php 的 parse-time 就出错了（不是 run-time ），所以不能回调 register_shutdown_function()中注册的函数。

2.error_handler.php

<?php
register_shutdown_function("error_handler");
function error_handler(){
    echo "Yeah,it's worked!";
}
if(true){
   function test(){}
}
function test(){}

原因分析
我们看到，上面回调了 register_shutdown_function()中注册的函数。因为我们加了一个 if()判断，if()里面的 test()方法，相当于一个闭包，与外面的 test()名称不冲突。也就是，上面的代码在 parse-time 没有出错，而是在 run-time 的时候出错了，所以我们能够获取到 fatal error。

3.error_handler.php

<?php
register_shutdown_function("error_handler");
function error_handler(){
    echo "Yeah,it's worked!";
}

test.php

<?php
include './error_handler.php';
function test(){}
function test(){}

原因分析
当我们在运行 test.php 的时候,因为 redeclare 了两个 test()方法，所以 php 的语法解析器在 parse-time 的时候就出错了。所以不能回调 register_shutdown_function()中的方法，不能 catch 住这个 fatal error。

4.error_handler.php

<?php
register_shutdown_function("error_handler");
function error_handler(){
    echo "Yeah,it's worked!";
}

test.php

<?php
function test(){}
function test(){}

include_all.php

<?php
require './error_handler.php';
require './test.php';

执行 include_all.php

结果分析
上面我们捕获了 fatal_error。因为在运行 include_all.php 的时候，include_all.php 本身语法并没有出错，也就是在 parse-time 的时候并没有出错，而是 include 的文件出错了，也就是在 run-time 的时候出错了，这个时候是能回调 register_shutdown_function()中的函数的。

强烈建议：如果我们要使用 register_shutdown_function 进行错误捕捉，使用最后一种方法，可以确保错误都能捕捉到。error_handler 脚本吧，确保每次都能获取到想要的 Fatal Error

<?php
register_shutdown_function( "fatal_handler" );
set_error_handler("error_handler");

define('E_FATAL',  E_ERROR | E_USER_ERROR |  E_CORE_ERROR | 
        E_COMPILE_ERROR | E_RECOVERABLE_ERROR| E_PARSE );

//获取 fatal error
function fatal_handler() {
    $error = error_get_last();
    if($error && ($error["type"]===($error["type"] & E_FATAL))) {
        $errno   = $error["type"];
        $errfile = $error["file"];
        $errline = $error["line"];
        $errstr  = $error["message"];
        error_handler($errno,$errstr,$errfile,$errline);
  }
}
//获取所有的 error
function error_handler($errno,$errstr,$errfile,$errline){
    $str=<<<EOF
         "errno":$errno
         "errstr":$errstr
         "errfile":$errfile
         "errline":$errline
EOF;
//获取到错误可以自己处理，比如记 Log、报警等等
    echo $str;
}