如何捕获 PHP 致命错误（`E_ERROR`）？

Question

我可以使用set_error_handler()来捕获大多数PHP错误，但它无法处理致命错误(E_ERROR)，例如调用不存在的函数。是否有另一种方法来捕获这些错误？

我正尝试在所有错误时调用mail()，并且正在运行PHP 5.2.3。

- Peter

---

我写了一个类似维基百科的问答，提供了PHP中捕获所有错误的完整解决方案；可以在Stack Overflow上查看、借鉴、抄袭或评论。该解决方案包括五种方法，可以包装PHP可能生成的所有错误，并最终将这些错误传递给一个“ErrorHandler”类型的对象。 - DigitalJedi805

参见：https://dev59.com/OHNA5IYBdhLWcg3wHp-B - dreftymac

参见：https://bugs.php.net/bug.php?id=41418 - dreftymac

参见：https://dev59.com/f2w05IYBdhLWcg3wpDVu - dreftymac

我提供了一个适用于PHP 7的简单答案：https://dev59.com/f2w05IYBdhLWcg3wpDVu - David Spector

Answer 1

使用register_shutdown_function记录致命错误，需要PHP 5.2+：

register_shutdown_function( "fatal_handler" );

function fatal_handler() {
    $errfile = "unknown file";
    $errstr  = "shutdown";
    $errno   = E_CORE_ERROR;
    $errline = 0;

    $error = error_get_last();

    if($error !== NULL) {
        $errno   = $error["type"];
        $errfile = $error["file"];
        $errline = $error["line"];
        $errstr  = $error["message"];

        error_mail(format_error( $errno, $errstr, $errfile, $errline));
    }
}

您需要定义error_mail和format_error函数。例如：

function format_error( $errno, $errstr, $errfile, $errline ) {
    $trace = print_r( debug_backtrace( false ), true );

    $content = "
    <table>
        <thead><th>Item</th><th>Description</th></thead>
        <tbody>
            <tr>
                <th>Error</th>
                <td><pre>$errstr</pre></td>
            </tr>
            <tr>
                <th>Errno</th>
                <td><pre>$errno</pre></td>
            </tr>
            <tr>
                <th>File</th>
                <td>$errfile</td>
            </tr>
            <tr>
                <th>Line</th>
                <td>$errline</td>
            </tr>
            <tr>
                <th>Trace</th>
                <td><pre>$trace</pre></td>
            </tr>
        </tbody>
    </table>";
    return $content;
}

使用Swift Mailer编写error_mail函数。

另请参见：

• $php_errormsg
• 预定义常量

- user259973

---

这是实际正确的答案。我不知道为什么人们会纠结于“无法从致命错误中恢复”——问题并没有提到恢复。 - David Harkness

谢谢，不错。从致命错误（例如内存限制）中恢复并不是我想尝试的，但使这些错误可发现（无需客户提交支持票）可以产生很大的差异。 - Ilija

使用基本邮件：mail("[e-mail]", "My Site: FATAL ERROR", "Details: " . $errno . ' ' . $errstr . ' ' . $errfile . ' ' . $errline); 这行代码会发送一封邮件到"[e-mail]"，邮件标题为"My Site: FATAL ERROR"，内容包括错误相关的详细信息。其中，"$errno"代表错误号码，"$errstr"代表错误信息，"$errfile"代表发生错误的文件名，"$errline"代表发生错误的行数。 - Eric

@ScottNicol Slava V 是正确的，因为 shutdown 函数会在脚本运行完毕时被调用。目前代码的写法会导致在每次页面加载时都发送一封电子邮件。 - Nate

注意：这不是100%正确的答案。任何使用@符号来忽略错误的地方仍然会设置最后一个错误（以便您可以处理错误）。因此，您的脚本可以顺利完成，但register_shutdown_function仍然认为发生了错误。直到PHP 7，它们才有了一个函数error_clear_last()。 - Rahly

Answer 2

我刚想出了这个解决方案（PHP 5.2.0+）：

function shutDownFunction() {
    $error = error_get_last();
     // Fatal error, E_ERROR === 1
    if ($error['type'] === E_ERROR) {
         // Do your stuff
    }
}
register_shutdown_function('shutDownFunction');

不同的错误类型在预定义常量中有定义。

- periklis

---

这个解决方案对我来说比最高评分的答案更有用。最高评分的答案每次脚本运行时都会发送电子邮件，即使没有错误也是如此。这个解决方案仅在发生致命错误时运行。 - kmoney12

@periklis，如果最后一个错误已经被处理，error_get_last仍然会返回它，不是吗？ - Pacerier

@Pacerier，我不确定你所说的“handled”是什么意思，因为错误并不是异常，但我想答案是“是”。 - periklis

@Pacerier 我明白了，这是一个有趣的问题。请查看http://www.php.net/error_get_last，其中一个评论提到：“如果错误处理程序（参见set_error_handler）成功处理错误，则该函数不会报告该错误。” - periklis

或许这很明显，调用register_shutdown_function()必须早于任何致命错误。在use_1T_memory(); /* memory exhausted error here! */ register_shutdown_function('shutDownFunction');中使用该函数将无法按预期工作。 - Nobu

Answer 3

PHP没有提供传统的方法来捕获和恢复致命错误。这是因为通常在致命错误后处理过程不应该被恢复。使用字符串匹配输出缓冲区（如PHP.net上所述的技术）绝对是不明智的。这种方法根本不可靠。

在错误处理程序方法中调用mail()函数也会带来问题。如果有很多错误，你的邮件服务器将会负载过重，你可能会发现自己的收件箱里满是麻烦。为避免这种情况，你可以考虑定期运行cron扫描错误日志并相应地发送通知。你还可以看看系统监控软件，例如Nagios。

---

关于注册关闭函数:

确实可以注册一个关闭函数，这是个好答案。

这里的重点是我们通常不应该尝试从致命错误中恢复，特别是不应该通过针对输出缓冲区进行正则表达式匹配。我在回应接受的答案，该答案链接到了一个建议在php.net上的内容，但已经被更改或删除了。

该建议是在异常处理期间针对输出缓冲区使用正则表达式，在检测到致命错误（通过匹配你可能期望的任何配置错误文本）时，尝试进行一些恢复或继续处理。这不是推荐的做法（我认为这也是为什么我找不到原始建议的原因之一，我可能正在忽略它，或php社区已经否定了它）。

值得注意的是，PHP的更新版本（大约5.1左右）似乎会在调用输出缓冲回调函数之前更早地调用关闭函数。在5及更早版本中，这种顺序是相反的（输出缓冲回调函数后面是关闭函数）。此外，自约5.0.5以来（远早于提问者的版本5.2.3），对象在注册的关闭函数被调用之前就已经被卸载了，因此您不能依赖内存中的对象来完成任何任务。

因此，注册关闭函数是可以的，但应该执行的关闭操作可能仅限于一些温和的关闭过程。

关键的信息是，对于任何发现此问题并看到原始接受答案中的建议的人，需要注意避免使用正则表达式处理输出缓冲区。

- keparo

---

我记得那天早上我收到了超过65万封电子邮件，自那以后，我的错误处理程序每个Web服务器每天只处理100封电子邮件。 - Bob Fanger

不是这样的。你可以使用register_shutdown_function来捕获致命错误。 - hipertracker

有时需要捕获致命错误的应用场景。例如，测试套件在一个测试失败时不应该停止，而是应该报告这个致命错误并继续进行下一个测试。PHP 将太多的事情定义为“致命”错误。 - Chad

说他们“不应该被发现”是非常短视的。在生产系统中，你需要知道何时出现故障（设置电子邮件或将日志记录在数据库中 - 默认的php错误处理功能不是非常复杂）。 - B T

关于“需要捕获错误以便我们能够修复它们”的观点，我想快速评论一下。ini指令ini log_errors和error_log。 - Kelly Elton

Answer 4

在PHP 7及更高版本中，致命错误或可恢复的致命错误现在会抛出Error实例。与其他异常一样，可以使用try/catch块捕获Error对象。

示例：

<?php
$variable = 'not an object';

try {
    $variable->method(); // Throws an Error object in PHP 7 or higger.
} catch (Error $e) {
    // Handle error
    echo $e->getMessage(); // Call to a member function method() on string
}

https://3v4l.org/67vbk

或者您可以使用Throwable接口来捕获所有异常。

示例：

<?php
    try {
        undefinedFunctionCall();
    } catch (Throwable $e) {
        // Handle error
        echo $e->getMessage(); // Call to undefined function undefinedFunctionCall()
    }

https://3v4l.org/Br0MG

更多信息请参见：http://php.net/manual/en/language.errors.php7.php

- LugiHaue

---

如何使用这个方法来捕获使用ReflectionClass时出现的类似于“致命错误：Trait 'FailedTrait'未找到”的错误？ - TCB13

@TCB13 尝试将 try 块内的内容封装在一个文件中，并使用 include "filename.php" 代替，这样至少可以让 Throwable catch 块能够捕获 ParseError。 - Niloct

在 PHP 中，使用小写字母 e 表示异常是否有影响，或者必须使用大写字母 E 表示 Exception？ - kstubs

这适用于大多数错误，但仍有一些会导致立即关闭，例如内存耗尽。对于这些错误，关闭处理程序仍然是发出自定义响应的唯一优雅方式。 - IMSoP

即使在PHP 8.0中，它仍然无法处理“Declaration of ... must be compatible with...”错误。 - Yevgeniy Afanasyev

Answer 5

嗯，似乎有其他方法可以捕获致命错误 :)

ob_start('fatal_error_handler');

function fatal_error_handler($buffer){
    $error = error_get_last();
    if($error['type'] == 1){
        // Type, message, file, line
        $newBuffer='<html><header><title>Fatal Error </title></header>
                      <style>
                    .error_content{
                        background: ghostwhite;
                        vertical-align: middle;
                        margin:0 auto;
                        padding: 10px;
                        width: 50%;
                     }
                     .error_content label{color: red;font-family: Georgia;font-size: 16pt;font-style: italic;}
                     .error_content ul li{ background: none repeat scroll 0 0 FloralWhite;
                                border: 1px solid AliceBlue;
                                display: block;
                                font-family: monospace;
                                padding: 2%;
                                text-align: left;
                      }
                      </style>
                      <body style="text-align: center;">
                        <div class="error_content">
                             <label >Fatal Error </label>
                             <ul>
                               <li><b>Line</b> ' . $error['line'] . '</li>
                               <li><b>Message</b> ' . $error['message'] . '</li>
                               <li><b>File</b> ' . $error['file'] . '</li>
                             </ul>

                             <a href="javascript:history.back()"> Back </a>
                        </div>
                      </body></html>';

        return $newBuffer;
    }
    return $buffer;
}

- sakhunzai

---

如果我能的话，我会给这个10个赞。当页面崩溃时，有时会出现一些奇怪的错误，什么都没有被记录下来，但这对我来说完美地解决了问题。虽然我不会在实际生产代码中使用它，但在需要快速找到失败原因时，将其添加到页面中非常棒。谢谢！ - Night Owl

我在互联网上找到的最佳解决方案之一。运行得非常好。 - Bounce

以什么方式？需要解释一下，特别是如果它是互联网上最好的解决方案之一（它可能变得更好）。 - Peter Mortensen

所有的CSS内容都是必需的吗？它不能被简化为必要的部分吗？请通过编辑您的答案来回应，而不是在评论中回应（如果适用）。 - Peter Mortensen

@PeterMortensen 我并不声称这是最好的解决方案。这只是我个人解决问题的方法，还有其他更好的、更专业的选择。正如某人所建议的那样，它并不适合生产环境。CSS存在是因为我只是剪切粘贴了我的个人代码。 - sakhunzai

@PeterMortensen，针对这个问题并没有单一的解决方案，它可能因为解决了用户所面临的问题而获得了赞，而不是因为它是最好的。 - sakhunzai

Answer 6

你无法捕获/处理致命错误，但可以将它们记录/报告。

为了快速调试，我修改了这段简单代码中的一个答案

function __fatalHandler()
{
    $error = error_get_last();

    // Check if it's a core/fatal error, otherwise it's a normal shutdown
    if ($error !== NULL && in_array($error['type'],
        array(E_ERROR, E_PARSE, E_CORE_ERROR, E_CORE_WARNING,
              E_COMPILE_ERROR, E_COMPILE_WARNING,E_RECOVERABLE_ERROR))) {

        echo "<pre>fatal error:\n";
        print_r($error);
        echo "</pre>";
        die;
    }
}

register_shutdown_function('__fatalHandler');

- zainengineer

---

@TKoL 第一行。 基本上是你的脚本/程序的入口文件，因此它会首先执行，如果不可能，请将其放在一个公共文件中。 - zainengineer

关闭处理程序将在执行结束时打印错误，它不会中断脚本（我不理解这种行为）。 - Loenix

一些错误仍未被捕获。 - Loenix

Answer 7

我开发了一种方法来捕获 PHP 中的所有错误类型（几乎所有）！我不确定 E_CORE_ERROR 是否有效（我认为仅对该错误无效）！但是，对于其他致命错误（E_ERROR、E_PARSE、E_COMPILE 等），只使用一个错误处理函数即可正常工作！以下是我的解决方案：

将下面的代码放在您的主文件（index.php）中：

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

    define('ENV', 'dev');

    // Custom error handling vars
    define('DISPLAY_ERRORS', TRUE);
    define('ERROR_REPORTING', E_ALL | E_STRICT);
    define('LOG_ERRORS', TRUE);

    register_shutdown_function('shut');

    set_error_handler('handler');

    // Function to catch no user error handler function errors...
    function shut(){

        $error = error_get_last();

        if($error && ($error['type'] & E_FATAL)){
            handler($error['type'], $error['message'], $error['file'], $error['line']);
        }

    }

    function handler( $errno, $errstr, $errfile, $errline ) {

        switch ($errno){

            case E_ERROR: // 1 //
                $typestr = 'E_ERROR'; break;
            case E_WARNING: // 2 //
                $typestr = 'E_WARNING'; break;
            case E_PARSE: // 4 //
                $typestr = 'E_PARSE'; break;
            case E_NOTICE: // 8 //
                $typestr = 'E_NOTICE'; break;
            case E_CORE_ERROR: // 16 //
                $typestr = 'E_CORE_ERROR'; break;
            case E_CORE_WARNING: // 32 //
                $typestr = 'E_CORE_WARNING'; break;
            case E_COMPILE_ERROR: // 64 //
                $typestr = 'E_COMPILE_ERROR'; break;
            case E_CORE_WARNING: // 128 //
                $typestr = 'E_COMPILE_WARNING'; break;
            case E_USER_ERROR: // 256 //
                $typestr = 'E_USER_ERROR'; break;
            case E_USER_WARNING: // 512 //
                $typestr = 'E_USER_WARNING'; break;
            case E_USER_NOTICE: // 1024 //
                $typestr = 'E_USER_NOTICE'; break;
            case E_STRICT: // 2048 //
                $typestr = 'E_STRICT'; break;
            case E_RECOVERABLE_ERROR: // 4096 //
                $typestr = 'E_RECOVERABLE_ERROR'; break;
            case E_DEPRECATED: // 8192 //
                $typestr = 'E_DEPRECATED'; break;
            case E_USER_DEPRECATED: // 16384 //
                $typestr = 'E_USER_DEPRECATED'; break;
        }

        $message =
            '<b>' . $typestr .
            ': </b>' . $errstr .
            ' in <b>' . $errfile .
            '</b> on line <b>' . $errline .
            '</b><br/>';

        if(($errno & E_FATAL) && ENV === 'production'){

            header('Location: 500.html');
            header('Status: 500 Internal Server Error');

        }

        if(!($errno & ERROR_REPORTING))
            return;

        if(DISPLAY_ERRORS)
            printf('%s', $message);

        //Logging error on php file error log...
        if(LOG_ERRORS)
            error_log(strip_tags($message), 0);
    }

    ob_start();

    @include 'content.php';

    ob_end_flush();
?>

- Lucas Batistussi

---

这行代码 @include 'content.php' 是做什么的？ - Marco

Answer 8

您不能在已注册的关闭函数中这样抛出异常：

<?php
    function shutdown() {
        if (($error = error_get_last())) {
           ob_clean();
           throw new Exception("fatal error");
        }
    }

    try {
        $x = null;
        $x->method()
    } catch(Exception $e) {
        # This won't work
    }
?>

但是你可以捕获并重定向请求到另一个页面。

<?php
    function shutdown() {
        if (($error = error_get_last())) {
           ob_clean();
           # Report the event, send email, etc.
           header("Location: http://localhost/error-capture");
           # From /error-capture. You can use another
           # redirect, to e.g. the home page
        }
    }
    register_shutdown_function('shutdown');

    $x = null;
    $x->method()
?>

- hipertracker

Answer 9

如果您使用的是PHP >= 5.1.0，只需像这样使用ErrorException类：

<?php
    // Define an error handler
    function exception_error_handler($errno, $errstr, $errfile, $errline ) {
        throw new ErrorException($errstr, $errno, 0, $errfile, $errline);
    }

    // Set your error handler
    set_error_handler("exception_error_handler");

    /* Trigger exception */
    try
    {
        // Try to do something like finding the end of the internet
    }
    catch(ErrorException $e)
    {
        // Anything you want to do with $e
    }
?>

- Cyril Tata

Answer 10

我需要处理生产环境中的致命错误，并显示一个静态样式的 503服务不可用 HTML 输出。这肯定是一种合理的“捕获致命错误”的方法。以下是我的做法：

我有一个自定义的错误处理函数“error_handler”，它会在任何 E_ERROR，E_USER_ERROR 等错误时显示我的“503服务不可用”HTML页面。现在，在关闭函数上调用该函数，以捕获我的致命错误。

function fatal_error_handler() {

    if (@is_array($e = @error_get_last())) {
        $code = isset($e['type']) ? $e['type'] : 0;
        $msg = isset($e['message']) ? $e['message'] : '';
        $file = isset($e['file']) ? $e['file'] : '';
        $line = isset($e['line']) ? $e['line'] : '';
        if ($code>0)
            error_handler($code, $msg, $file, $line);
    }
}
set_error_handler("error_handler");
register_shutdown_function('fatal_error_handler');

在我的自定义error_handler函数中，如果错误是E_ERROR、E_USER_ERROR等，我也会调用@ob_end_clean();来清空缓冲区，从而删除PHP的“致命错误”信息。

请注意严格的isset()检查和@静音函数，因为我们不希望我们的error_handler脚本生成任何错误。

与keparo仍然一致，捕获致命错误确实违背了“致命错误”的目的，因此不打算进一步处理。在此关闭过程中不要运行任何mail()函数，否则您肯定会备份邮件服务器或收件箱。而是将这些发生记录到文件中，并安排一个cron作业来查找这些error.log文件并将它们发送给管理员。

- Prof