如何捕获 PHP 致命 (`E_ERROR`) 错误？
我可以使用 set_error_handler() 捕获大多数 PHP 错误，但它不适用于致命 (E_ERROR) 错误，例如调用不存在的函数。还有其他方法可以捕获这些错误吗？
我正在尝试为所有错误调用 mail()，并且正在运行 PHP 5.2.3。
使用 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
预定义常量
我刚刚想出了这个解决方案（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');
Predefined Constants 中定义了不同的错误类型。
If an error handler (see set_error_handler ) successfully handles an error then that error will not be reported by this function.”
register_shutdown_function() 必须早于任何致命错误。 use_1T_memory(); /* memory exhausted error here! */ register_shutdown_function('shutDownFunction'); 不会按预期工作。
PHP 没有提供传统的方法来捕获致命错误并从中恢复。这是因为处理通常不应在致命错误后恢复。匹配输出缓冲区的字符串（如原始帖子所建议的那样，PHP.net 上描述的技术）绝对是不明智的。这简直是不可靠的。
从错误处理程序方法中调用 mail() 函数也被证明是有问题的。如果你有很多错误，你的邮件服务器就会加载很多工作，你会发现自己的收件箱很粗糙。为避免这种情况，您可以考虑运行 cron 定期扫描错误日志并相应地发送通知。您可能还想研究系统监控软件，例如 Nagios。
谈谈有关注册关闭功能的信息：
确实可以注册关机功能，这是一个很好的答案。
这里的重点是，我们通常不应该尝试从致命错误中恢复，尤其是不要对输出缓冲区使用正则表达式。我正在回复 accepted answer，它链接到 php.net 上的一个建议，该建议已被更改或删除。
该建议是在异常处理期间对输出缓冲区使用正则表达式，并且在发生致命错误的情况下（通过与您可能期望的任何配置错误文本的匹配检测到），尝试进行某种恢复或继续处理。这不是推荐的做法（我相信这也是我找不到原始建议的原因。我要么忽略它，要么 php 社区将其击落）。
可能值得注意的是，较新的 PHP 版本（大约 5.1）似乎在调用输出缓冲回调之前更早地调用了关闭函数。在版本 5 和更早的版本中，该顺序是相反的（输出缓冲回调之后是关闭函数）。此外，由于大约 5.0.5（比提问者的版本 5.2.3 早得多），对象在调用已注册的关闭函数之前就已卸载，因此您将无法依赖内存中的对象来执行很多东西。
所以注册一个关闭函数是好的，但是应该由一个关闭函数执行的任务可能仅限于少数几个温和的关闭过程。
对于偶然发现这个问题并在最初接受的答案中看到建议的人来说，这里的关键要点只是一些智慧的话。不要正则表达式你的输出缓冲区。
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
}
或者您可以使用 Throwable 接口来捕获所有异常。
例子：
<?php
try {
undefinedFunctionCall();
} catch (Throwable $e) {
// Handle error
echo $e->getMessage(); // Call to undefined function undefinedFunctionCall()
}
有关详细信息：http://php.net/manual/en/language.errors.php7.php
ReflectionClass 时使用它来捕获像 Fatal error: Trait 'FailedTrait' not found in 这样的错误的任何想法？
include "filename.php" 包装在 try 块中，然后 Throwable catch 块至少适用于 ParseError。
Declaration of ... must be compatible with...
好吧，似乎有可能以其他方式捕获致命错误:)
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;
}
您无法捕获/处理致命错误，但您可以记录/报告它们。为了快速调试，我修改了这个简单代码的一个答案
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 中的所有错误类型（几乎所有）！我不确定 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
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()
?>
如果您使用的是 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
}
?>
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。然后你也可以停止 Handler。
使用此类，例如：
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;
}
// [...]
}
我需要处理生产中的致命错误，以显示静态样式的 503 Service Unavailable 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 文件并将它们邮寄给管理员。
这只是获取当前 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) {
// 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 停止显示错误。否则，错误文本将在您的错误处理程序之前发送到客户端。
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 错误，但由于引擎处于不稳定状态，因此无法从中恢复。
由于这里的大多数答案都不必要地冗长，因此这是我的最高投票答案的非丑陋版本：
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");
并不真地。致命错误被称为致命错误，因为它们是致命的。你无法从他们身上恢复过来。
我开发了这个功能，以使“沙箱”代码成为可能，这可能会导致致命错误。由于闭包 register_shutdown_function 抛出的异常不会从 pre-fatal 错误调用堆栈中发出，因此我被迫在此函数之后退出以提供统一的使用方式。
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();
}
在某些情况下，即使是致命错误也应该被捕获（您可能需要在优雅退出之前进行一些清理，而不仅仅是死掉......）。
我在我的 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();
}
}
从 PHP 7.4.13 开始，我的经验是，程序中所有可能的错误和异常都可以通过两个回调函数来捕获：
set_error_handler("ErrorCB");
set_exception_handler("ExceptCB");
ErrorCB 只是以任何所需的方式报告其参数并调用 Exit()。
exceptCB 在其异常参数上调用“get”方法，并执行一些逻辑来确定文件、行和函数的位置（询问我是否需要详细信息），并以任何所需的方式报告信息并返回。
唯一需要 try/catch 是如果您需要抑制某些代码的错误，而 @ 或 isset() 还不够。在不设置处理程序的情况下对“主函数”使用 try/catch 会失败，因为它不会捕获所有错误。
如果有人发现生成此方法无法捕获的错误的代码，请告诉我，我将编辑此答案。这种方法无法拦截的一个错误是 PHP 程序末尾附近的单个 { 字符；这会产生一个 Parse 错误，这要求您通过包含错误处理的 Include 文件运行您的主 PHP 程序。
我还没有发现需要 register_shutdown_function()。
请注意，我关心的只是报告错误然后退出程序；我不需要从错误中恢复——这确实是一个更困难的问题。
mail("myname@myemail.com", "My Site: FATAL ERROR", "Details: " . $errno . ' ' . $errstr . ' ' . $errfile . ' ' . $errline);