PHP8 怎么捕获致命错误实操代码-php教程-PHP中文网

php 8 中致命错误分两类：可捕获的 error（如 typeerror）和不可恢复的真正致命错误（如扩展未加载）。应组合使用 catch(throwable) 捕获引擎错误并兜底处理，配合 register_shutdown_function 补漏，同时配置扩展主动抛异常及 set_error_handler 统一警告流。

php8 怎么捕获致命错误实操代码

PHP 8 中“致命错误”已大幅可捕获，但需分清两类场景：一类是能被 try/catch 拦截的引擎级 Error（如 TypeError、ParseError），另一类是仍会直接终止脚本的真正不可恢复错误（如扩展未加载、语法错误在顶层、内存耗尽）。实操关键不是“统一 catch”，而是组合使用两种机制。

用 catch(Throwable $e) 捕获可转为 Error 的运行时崩溃

PHP 7+ 将多数原本致命的错误升级为 Error 子类，它们实现了 Throwable 接口，因此可被 catch(Throwable) 捕获。但注意：catch(Exception) 完全无效。

必须写 catch(Throwable $e)，不能只写 Exception
捕获后立刻用 $e instanceof Error 判断是否为引擎错误
对 Error 类型应中止后续逻辑、记录完整堆栈、返回通用 500 响应
对 Exception 类型可做业务化处理（如重试、降级、友好提示）

示例代码：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

try {
    json_decode('{invalid}', flags: JSON_THROW_ON_ERROR);
    $obj = new stdClass();
    $obj->undefinedMethod();
} catch (Throwable $e) {
    if ($e instanceof Error) {
        error_log('CRITICAL ENGINE ERROR: ' . $e->getTraceAsString());
        http_response_code(500);
        echo 'Service unavailable';
        exit;
    }
    // 此处 $e 必为 Exception 或其子类
    error_log('Business exception: ' . $e->getMessage());
    echo '操作失败，请稍后重试';
}

用 register_shutdown_function + error_get_last() 补漏真正致命错误

某些错误（如调用未定义函数 curl_init()、eval 中严重语法错误、PHP 启动失败）仍无法被 try/catch 捕获。这时必须依赖 register_shutdown_function —— 它在脚本退出前强制执行一次回调，配合 error_get_last() 获取最后发生的致命错误。

必须放在入口文件最顶部（如 index.php 第一行之后）
只检查 E_ERROR、E_PARSE、E_CORE_ERROR、E_COMPILE_ERROR 这几类致命级别
不要在 shutdown 函数里再抛异常或触发新错误，否则掩盖原始问题
它不能阻止崩溃，仅用于日志记录和兜底响应

示例代码：

register_shutdown_function(function () {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        error_log(sprintf(
            '[FATAL] %s in %s:%d',
            $error['message'],
            $error['file'] ?? 'unknown',
            $error['line'] ?? 0
        ));
        // 生产环境建议输出静态错误页，开发环境可显示详情
        if (filter_var(ini_get('display_errors'), FILTER_VALIDATE_BOOLEAN) === false) {
            http_response_code(500);
            echo '系统繁忙，请稍后再试。';
        }
    }
});

配置 PDO 等扩展主动抛出异常而非静默失败

很多“看似致命”的问题其实源于扩展默认不抛异常。例如 PDO 默认是 PDO::ERRMODE_SILENT，出错只设错误码，不中断也不报错；只有显式启用 PDO::ERRMODE_EXCEPTION 才会抛出 PDOException（属于 Exception，可被正常捕获）。

PHP 8.0+ 已将 PDO::ERRMODE_EXCEPTION 设为默认，但旧项目或手动创建连接时仍需确认
类似机制也存在于其他扩展（如 mysqli 的 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT)）
避免在每个查询后手动检查 errorCode()，改用异常流统一处理

示例：

$pdo = new PDO($dsn, $user, $pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
<p>try {
$pdo->query("SELECT * FROM nonexistent_table");
} catch (PDOException $e) {
// 可捕获，且属于 Exception，非 Error
logDbError($e);
renderUserFriendlyMessage('数据暂不可用');
}</p>

别忘了 set_error_handler 处理非致命警告

虽然它抓不到 Fatal error，但对 E_WARNING、E_NOTICE、E_DEPRECATED 等非常有用。可配合 throw new ErrorException($message, $code, $severity, $file, $line) 把它们转为异常，再由 catch(Throwable) 统一处理，实现“警告也进异常流”。

在入口文件设置：set_error_handler('handlePhpError')
函数内对 E_WARNING 等级别 throw 新的 ErrorException
这样所有错误最终都走 Throwable 流程，逻辑更集中

示例片段：

function handlePhpError(int $errno, string $errstr, string $errfile, int $errline): void
{
    if (!(error_reporting() & $errno)) {
        return;
    }
    if (in_array($errno, [E_WARNING, E_NOTICE, E_USER_WARNING, E_USER_NOTICE])) {
        throw new ErrorException($errstr, 0, $errno, $errfile, $errline);
    }
}
<p>set_error_handler('handlePhpError');</p>

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！