我如何捕获PHP致命错误

时间:2008-11-10 06:42:28

标签: php fatal-error

我可以使用set_error_handler()来捕获大多数PHP错误,但它不适用于致命(E_ERROR)错误,例如调用不存在的函数。还有另一种方法来捕捉这些错误吗?

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

19 个答案:

答案 0 :(得分:609)

使用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_mailformat_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功能。

另见:

答案 1 :(得分:137)

刚刚提出这个解决方案(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');

http://www.php.net/manual/en/errorfunc.constants.php

定义的不同错误类型

答案 2 :(得分:113)

PHP不提供用于捕获和从致命错误中恢复的常规方法。这是因为在致命错误之后通常不应该恢复处理。匹配输出缓冲区的字符串(正如PHP.net上描述的原始帖子所建议的那样)绝对是不明智的。这简直不可靠。

从错误处理程序方法中调用mail()函数也证明是有问题的。如果你有很多错误,你的邮件服务器将被加载工作,你可能会发现自己有一个粗糙的收件箱。为避免这种情况,您可以考虑运行cron来定期扫描错误日志并相应地发送通知。您可能还想查看系统监控软件,例如Nagios


关于注册关闭功能的问题:

你可以注册关机功能,这是一个很好的答案。

这里的要点是我们通常不应该尝试从致命错误中恢复,特别是不要对输出缓冲区使用正则表达式。我正在回复accepted answer,它与php.net上的一个建议相关联,该建议已被更改或删除。

该建议是在异常处理期间对输出缓冲区使用正则表达式,并且在致命错误的情况下(通过匹配您可能期望的任何已配置的错误文本来检测),尝试进行某种恢复或继续处理。这不是一个推荐的做法(我相信这也是我无法找到原始建议的原因。我要么忽略它,要么php社区将其击落)。

值得注意的是,在输出缓冲回调被调用之前,更新版本的PHP(大约5.1)似乎更早地调用了shutdown函数。在版本5和更早版本中,该顺序是相反的(输出缓冲回调后跟关闭函数)。此外,由于大约5.0.5(比提问者的版本5.2.3早得多),在调用注册的关闭函数之前很快就会卸载对象,因此您将无法依赖内存中的对象来执行操作很多东西。

因此注册关闭函数很好,但是关闭函数应该执行的任务可能仅限于少数温和的关闭过程。

对于那些偶然发现这个问题并在最初接受的答案中看到建议的人来说,这里的关键外卖只是一些智慧的话语。不要正则表达输出缓冲区。

答案 3 :(得分:37)

似乎有可能以其他方式捕获致命错误:)

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;

}

答案 4 :(得分:22)

我开发了一种方法来捕获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();

?>

我希望这可以帮助很多人!我在寻找这个解决方案的时间太长了,没找到!然后我开发了一个!

答案 5 :(得分:18)

您无法捕获/处理致命错误,但您可以记录/报告它们。 为了快速调试,我修改了这个简单代码的一个答案

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');

答案 6 :(得分:17)

你不能在注册的关闭函数中抛出异常,如:

<?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();
       # raport the event, send email etc.
       header("Location: http://localhost/error-capture");
       # from /error-capture, you can use another redirect, to e.g. home page
    }
}
register_shutdown_function('shutdown');

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

答案 7 :(得分:16)

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

示例:

<?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

答案 8 :(得分:11)

如果您使用的是php&gt; = 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 ur error handle
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
}

?>

答案 9 :(得分:9)

在Zend Framework 2中找到了很好的解决方案:

/**
 * ErrorHandler that can be used to catch internal PHP errors
 * and convert to an ErrorException instance.
 */
abstract class ErrorHandler
{
    /**
     * Active stack
     *
     * @var array
     */
    protected static $stack = array();

    /**
     * Check if this error handler is active
     *
     * @return bool
     */
    public static function started()
    {
        return (bool) static::getNestedLevel();
    }

    /**
     * Get the current nested level
     *
     * @return int
     */
    public static function getNestedLevel()
    {
        return count(static::$stack);
    }

    /**
     * Starting the error handler
     *
     * @param int $errorLevel
     */
    public static function start($errorLevel = \E_WARNING)
    {
        if (!static::$stack) {
            set_error_handler(array(get_called_class(), 'addError'), $errorLevel);
        }

        static::$stack[] = null;
    }

    /**
     * Stopping the error handler
     *
     * @param  bool $throw Throw the ErrorException if any
     * @return null|ErrorException
     * @throws ErrorException If an error has been catched and $throw is true
     */
    public static function stop($throw = false)
    {
        $errorException = null;

        if (static::$stack) {
            $errorException = array_pop(static::$stack);

            if (!static::$stack) {
                restore_error_handler();
            }

            if ($errorException && $throw) {
                throw $errorException;
            }
        }

        return $errorException;
    }

    /**
     * Stop all active handler
     *
     * @return void
     */
    public static function clean()
    {
        if (static::$stack) {
            restore_error_handler();
        }

        static::$stack = array();
    }

    /**
     * Add an error to the stack
     *
     * @param int    $errno
     * @param string $errstr
     * @param string $errfile
     * @param int    $errline
     * @return void
     */
    public static function addError($errno, $errstr = '', $errfile = '', $errline = 0)
    {
        $stack = & static::$stack[count(static::$stack) - 1];
        $stack = new ErrorException($errstr, 0, $errno, $errfile, $errline, $stack);
    }
}

如果您需要,此类允许您有时启动特定的ErrorHandler。然后你也可以停止处理程序。

使用此类,例如像这样:

ErrorHandler::start(E_WARNING);
$return = call_function_raises_E_WARNING();

if ($innerException = ErrorHandler::stop()) {
    throw new Exception('Special Exception Text', 0, $innerException);
}

// or
ErrorHandler::stop(true); // directly throws an Exception;

链接到完整的班级代码:
https://github.com/zendframework/zf2/blob/master/library/Zend/Stdlib/ErrorHandler.php


一个更好的解决方案就是来自Monolog

链接到完整的班级代码:
https://github.com/Seldaek/monolog/blob/master/src/Monolog/ErrorHandler.php

它还可以使用register_shutdown_function函数处理FATAL_ERRORS。根据此类,FATAL_ERROR是以下array(E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR)之一。

class ErrorHandler
{
    // [...]

    public function registerExceptionHandler($level = null, $callPrevious = true)
    {
        $prev = set_exception_handler(array($this, 'handleException'));
        $this->uncaughtExceptionLevel = $level;
        if ($callPrevious && $prev) {
            $this->previousExceptionHandler = $prev;
        }
    }

    public function registerErrorHandler(array $levelMap = array(), $callPrevious = true, $errorTypes = -1)
    {
        $prev = set_error_handler(array($this, 'handleError'), $errorTypes);
        $this->errorLevelMap = array_replace($this->defaultErrorLevelMap(), $levelMap);
        if ($callPrevious) {
            $this->previousErrorHandler = $prev ?: true;
        }
    }

    public function registerFatalHandler($level = null, $reservedMemorySize = 20)
    {
        register_shutdown_function(array($this, 'handleFatalError'));

        $this->reservedMemory = str_repeat(' ', 1024 * $reservedMemorySize);
        $this->fatalLevel = $level;
    }

    // [...]
}

答案 10 :(得分:8)

我需要为生产处理致命错误,而是显示静态样式的503 Service Unavailable HTML输出。这肯定是“捕捉致命错误”的合理方法。这就是我所做的:

我有一个自定义错误处理函数“error_handler”,它将在任何E_ERROR,E_USER_ERROR等上显示我的“503 service unavailable”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文件并将它们邮寄给管理员。

答案 11 :(得分:7)

PHP有可捕获的致命错误。它们被定义为E_RECOVERABLE_ERROR。 PHP手册将E_RECOVERABLE_ERROR描述为:

  

可捕获的致命错误。它表示发生了可能存在危险的错误,但没有使引擎处于不稳定状态。如果错误未被用户定义的句柄捕获(另请参阅set_error_handler()),则应用程序将中止,因为它是E_ERROR。

您可以使用set_error_handler()并检查E_RECOVERABLE_ERROR来“捕获”这些“致命”错误。我发现在捕获此错误时抛出异常是有用的,然后您可以使用try / catch。

这个问题和答案提供了一个有用的示例:How can I catch a "catchable fatal error" on PHP type hinting?

但是,

E_ERROR错误可以处理,但是在引擎处于不稳定状态时无法恢复。

答案 12 :(得分:5)

获取当前error_handler方法的好方法=)

<?php
register_shutdown_function('__fatalHandler');
function __fatalHandler()
{
    $error      = error_get_last();

    //check if it's a core/fatal error, otherwise it's a normal shutdown
    if($error !== NULL && $error['type'] === E_ERROR) {
        //Bit hackish, but the set_exception_handler will return the old handler
        function fakeHandler() { }
        $handler = set_exception_handler('fakeHandler');
        restore_exception_handler();
        if($handler !== null) { 
            call_user_func($handler, new ErrorException($error['message'], $error['type'], 0, $error['file'], $error['line']));
        }
        exit;
    }
}
?>

此外,我还要注意,如果你打电话

<?php
ini_set('display_errors', false);
?>

Php停止显示错误,否则错误文本将在错误处理程序之前发送到客户端

答案 13 :(得分:5)

由于这里的大多数答案都是不必要的冗长,这里是我最高投票答案的非丑陋版本:

function errorHandler($errno, $errstr, $errfile = '', $errline = 0, $errcontext = array()) {
    //Do stuff: mail, log, etc
}

function fatalHandler() {
    $error = error_get_last();
    if($error) errorHandler($error["type"], $error["message"], $error["file"], $error["line"]);
}

set_error_handler("errorHandler")
register_shutdown_function("fatalHandler");

答案 14 :(得分:4)

不是真的。致命的错误被称为致命错误,因为它们是致命的。你无法从中恢复。

答案 15 :(得分:3)

在某些情况下,甚至应该捕获致命的错误(你可能需要做一些清理才能优雅退出并且不要死...)。 我已经在我的codeigniter应用程序上实现了一个pre_system挂钩,这样我就可以通过电子邮件获取致命错误,这有助于我找到未报告的错误(或者在修复之后报告,因为我已经知道了它们:))。 Sendemail检查是否已经报告错误,以便它不会多次向您发送已知错误的垃圾邮件。

class PHPFatalError {

    public function setHandler() {
        register_shutdown_function('handleShutdown');
    }

}

function handleShutdown() {
    if (($error = error_get_last())) {
        ob_start();
        echo "<pre>";
        var_dump($error);
        echo "</pre>";
        $message = ob_get_clean();
        sendEmail($message);
        ob_start();
        echo '{"status":"error","message":"Internal application error!"}';
        ob_flush();
        exit();
    }
}

答案 16 :(得分:2)

我开发了这个函数,可以使“沙箱”代码成为可能导致致命错误的代码。由于从关闭register_shutdown_function抛出的异常不会从预致命错误调用堆栈中发出,因此我不得不在此函数之后退出以提供统一的使用方法。

function superTryCatchFinallyAndExit( Closure $try, Closure $catch = NULL, Closure $finally )
{
    $finished = FALSE;
    register_shutdown_function( function() use ( &$finished, $catch, $finally ) {
        if( ! $finished ) {
            $finished = TRUE;
            print "EXPLODE!".PHP_EOL;
            if( $catch ) {
                superTryCatchFinallyAndExit( function() use ( $catch ) {
                    $catch( new Exception( "Fatal Error!!!" ) );
                }, NULL, $finally );                
            } else {
                $finally();                
            }
        }
    } );
    try {
        $try();
    } catch( Exception $e ) {
        if( $catch ) {
            try {
                $catch( $e );
            } catch( Exception $e ) {}
        }
    }
    $finished = TRUE;
    $finally();
    exit();
}

答案 17 :(得分:1)

我用一个完整的解决方案编写了一个Wiki风格的Q&amp; A,用于捕获PHP中的所有错误;可以查看/收集/被盗/批评here

该解决方案包含5个方法,用于包装PHP可以生成的所有错误,最终将所述错误传递给'ErrorHandler'类型的对象。

希望有些人可以使用它。即使你没有彻底窃取它,我也确信解决方案至少是如何在PHP中处理错误的一个很好的例子 - 在各方面。

@Lucas Batistussi获得了创造力的分数 - 我想我也可以分享我的解决方案并拍摄一些类似的观点......

答案 18 :(得分:0)

从 PHP 7.4.13 开始,我的经验是程序中所有可能的错误和异常都可以通过两个回调函数来捕获:

set_error_handler("ErrorCB");
set_exception_handler("ExceptCB");

ErrorCB 只是以任何所需的方式报告其参数并调用 Exit()。

ExceptCB 在其异常参数上调用“get”方法,并执行一些逻辑来确定文件、行和函数的位置(询问我是否需要详细信息),并以任何所需的方式报告信息并返回。< /p>

try/catch 的唯一需要是如果您需要抑制某些代码的错误,当 @ 或 isset() 不够用时。在没有设置处理程序的情况下对“主函数”使用 try/catch 失败,因为它没有捕获所有错误。

如果有人发现生成此方法无法捕获的错误的代码,请告诉我,我将编辑此答案。这种方法无法拦截的一个错误是 PHP 程序末尾附近的单个 { 字符;这会生成解析错误,这要求您通过包含错误处理的 Include 文件运行主 PHP 程序。

我没有发现对 register_shutdown_function() 的任何需求。

请注意,我只关心报告错误然后退出程序;我不需要从错误中恢复——这确实是一个更困难的问题。