我如何捕捉PHP致命(' E_ERROR ')错误?

我可以使用set_error_handler()来捕获大多数PHP错误,但是对于致命错误(E_ERROR)它不起作用,比如调用一个不存在的函数。是否有其他方法来捕捉这些错误?

我试图调用mail()的所有错误和运行PHP 5.2.3。

408713 次浏览

不是真的。之所以叫致命错误,是因为它们是致命的。你无法从中恢复过来。

PHP没有提供常规的方法来捕捉和恢复致命错误。这是因为在发生致命错误后通常不应恢复处理。字符串匹配输出缓冲区(正如PHP.net上描述的技术的原始帖子所建议的那样)绝对是不明智的。这是不可靠的。

从错误处理程序方法中调用mail()函数也有问题。如果你有很多错误,你的邮件服务器就会有大量的工作,你就会发现自己有一个杂乱的收件箱。为了避免这种情况,可以考虑运行cron定期扫描错误日志并相应地发送通知。您可能还想研究一下系统监控软件,比如Nagios


关于注册一个shutdown函数:

的确,您可以注册一个shutdown函数,这是一个很好的答案。

这里的重点是,我们通常不应该试图从致命错误中恢复,特别是不应该对输出缓冲区使用正则表达式。我是在回复接受的答案,它链接到php.net上的一个建议,这个建议已经被更改或删除了。

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

值得注意的是,PHP的最新版本(大约5.1)似乎在调用输出缓冲回调之前更早地调用了shutdown函数。在版本5和更早的版本中,顺序是相反的(输出缓冲回调后面跟着shutdown函数)。此外,由于大约5.0.5(比提问者的5.2.3版本早得多),在调用已注册的shutdown函数之前就卸载了对象,因此您将不能依赖内存中的对象来做很多事情。

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

这里的关键是给那些偶然遇到这个问题并在最初接受的答案中看到建议的人的一些智慧之语。不要正则化你的输出缓冲区。

使用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;
}

使用斯威夫特梅勒编写error_mail函数。

参见:

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

预定义常量处定义了不同的错误类型。

你不能在一个已注册的shutdown函数中抛出一个异常:

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

好吧,似乎可以用其他方式捕获致命错误:)

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;
}

我需要处理生产的致命错误,而不是显示静态样式的503业务不可用 HTML输出。这无疑是“捕捉致命错误”的合理方法。这就是我所做的:

我有一个自定义错误处理函数“error_handler”,它将在任何E_ERROR, E_USER_ERROR等上显示我的“503服务不可用”HTML页面。这将被shutdown函数调用,捕捉致命错误,

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文件并将它们发送给管理员。

我开发这个函数是为了使“沙盒”代码能够导致致命错误。由于从闭包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();
}

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

可捕捉的致命错误。它表示可能发生了危险的错误,但没有使引擎处于不稳定状态。如果用户定义的句柄没有捕捉到错误(参见set_error_handler ()),应用程序将中止,因为它是一个E_ERROR。

您可以通过使用set_error_handler ()并检查E_RECOVERABLE_ERROR来“捕捉”这些“致命”错误。我发现当这个错误被捕获时抛出一个异常很有用,然后你可以使用try/catch。

这个问题和回答提供了一个有用的例子:我如何捕捉“可捕捉的致命错误”;PHP类型提示?

然而,E_ERROR错误可以处理,但不能恢复,因为引擎处于不稳定状态。

我开发了一种方法来捕获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();
?>
如果你使用PHP >= 5.1.0 只需对errorrexception类执行如下操作:

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

在某些情况下,即使是致命的错误也应该被捕获(你可能需要在优雅地退出之前做一些清理工作,而不是直接死亡..)。

我已经在我的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();
}
}

下面是一个获取当前error_handler method =)的小技巧

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


// It is a 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停止显示错误。否则,错误文本将先于错误处理程序发送给客户端。

在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

也许更好的解决方案是独白中的一个: 链接到完整的类代码:
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;
}


// [...]
}

由于这里的大多数答案都是不必要的啰嗦,下面是我投票最多的答案的不丑陋版本:

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");
你不能捕捉/处理致命错误,但是你可以记录/报告它们。 为了快速调试,我修改了这个简单代码

的一个答案
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');

致命错误或可恢复的致命错误现在在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

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

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

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

ExceptCB调用&;get"方法的异常参数,并执行一些逻辑来确定文件、行和函数的位置(如果您想要详细信息,请询问我),并以任何所需的方式报告信息并返回。

try/catch的唯一需要是当@或isset()不够用时,你需要抑制某些代码的错误。使用try/catch作为“main函数”;不设置处理程序会失败,因为它不会捕获所有错误。

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

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

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