如何捕获 PHP 致命错误 (E_ERROR)：陷阱与解决方案

如何捕获 PHP 致命错误 (E_ERROR) 并保持冷静

您是否曾经遇到过这种情况？您的 PHP 网站显示一个空白页面，没有任何错误信息。或者更糟的是，出现一个可怕的消息 Fatal error: Uncaught Error...。如果您是一名 PHP 开发者，您一定遇到过 E_ERROR——最令人头疼的错误类型。与警告 (Warnings) 或通知 (Notices) 不同，致命错误会完全停止脚本的执行。最令人沮丧的是：标准的 try...catch 块无法捕获它。

在本文中，我们将探讨如何正确捕获 PHP 致命错误，为什么常规方法不起作用，以及如何使您的代码更加健壮。这不仅仅是理论——我们将编写几个实际示例，您可以立即应用到自己的项目中。

为什么 try...catch 无法捕获 E_ERROR？

让我们先澄清一个误解：PHP 中的 try...catch 用于处理异常 (Exceptions)。而 E_ERROR 是一种错误 (Error)。它们是不同的实体。在 PHP 7.0 之前，根本无法捕获致命错误。从 PHP 7 开始，引入了 Error 类，它与 Exception 一样，实现了 Throwable 接口。但这并不意味着任何 E_ERROR 都会自动变成异常。例如，内存不足错误 (Out of memory) 或调用不存在的方法——这些仍然是致命错误，并不总能通过 try...catch 捕获。

这是一个简单的例子：

try {\n    $obj = new NonExistentClass(); // 这会触发 E_ERROR\n} catch (Throwable $e) {\n    echo '捕获到：' . $e->getMessage();\n}

在 PHP 7+ 中，这段代码可以工作，因为 Throwable 包含了 Error。但如果错误发生在编译阶段（例如语法错误）或 shutdown 阶段——try...catch 就无效了。

PHP 三大致命错误及如何避免

1. 调用不存在的方法或类

最常见的致命错误是 Call to undefined method 或 Class not found。当您尝试调用不存在的方法或使用未加载的类时会发生。

如何避免：

\n
• 始终使用类的自动加载（spl_autoload_register 或 Composer）。
\n
• 通过 method_exists() 检查方法是否存在。
\n

if (method_exists($object, 'someMethod')) {\n    $object->someMethod();\n} else {\n    // 处理逻辑\n}

2. 内存溢出 (Allowed memory size exhausted)

错误 Allowed memory size of X bytes exhausted 是一种致命错误，当脚本消耗的内存超过允许值时发生。它无法通过常规方式捕获。

如何避免：

\n
• 优化数据库查询。
\n
• 使用生成器 (yield) 处理大型数组。
\n
• 在 php.ini 中增加内存限制，或通过 ini_set('memory_limit', '256M') 设置。
\n

3. 执行超时 (Maximum execution time exceeded)

虽然这个错误不总是致命，但在某些配置下它会完全停止脚本执行。

如何避免：

\n
• 对于长时间运行的脚本，使用 set_time_limit(0)。
\n
• 将繁重的操作分解成多个部分。
\n

如何捕获 PHP 致命错误：3 种经过验证的方法

现在进入正题。有几种技术可以捕获 E_ERROR 并在脚本终止前执行代码。

方法 1. 使用 register_shutdown_function()