PHP如何捕获未处理异常？设置全局异常处理器

PHP中捕获所有未处理异常，关键在于设置顶层异常处理器。通过 set\_exception\_handler() 函数可以指定一个自定义函数来处理未被捕获的异常，避免程序崩溃时暴露敏感信息，同时实现统一的日志记录。

设置顶层异常处理器

使用 set\_exception\_handler() 可以注册一个全局异常处理函数。该函数会在抛出未被捕获的异常时自动调用：

function handleUncaughtException($exception) {
    // 记录异常信息到日志
    error\_log(
        "Uncaught Exception: " . $exception->getMessage() . "\n" .
        "File: " . $exception->getFile() . "\n" .
        "Line: " . $exception->getLine() . "\n" .
        "Trace:\n" . $exception->getTraceAsString(),
        3,
        "/var/log/php-app.log"
    );

    // 向用户显示友好提示（生产环境）
    if (php\_sapi\_name() === 'cli') {
        echo "Error: An unhandled exception occurred.\n";
    } else {
        http\_response\_code(500);
        echo "<h1>系统繁忙，请稍后再试</h1>";
    }
}

// 注册处理器
set\_exception\_handler('handleUncaughtException');

配合错误处理器处理非异常错误

PHP 中有些错误（如E\_ERROR）不会抛出异常，因此还需设置错误处理器。虽然 set\_error\_handler() 不能处理所有错误类型（如致命错误），但可覆盖大部分运行时错误：

function handleError($severity, $message, $file, $line) {
    if (!(error\_reporting() & $severity)) {
        return;
    }
    throw new ErrorException($message, 0, $severity, $file, $line);
}

set\_error\_handler('handleError');

这样可以把传统错误转换为异常，交由异常处理器统一处理。

恢复默认处理器（可选）

在某些场景下需要临时移除自定义处理器，可通过 restore\_exception\_handler() 恢复默认行为：

// 恢复默认处理器
restore\_exception\_handler();

日志记录策略建议

• 分级记录：根据异常类型或严重程度写入不同日志文件，例如 app-error.log、security.log
• 结构化日志：使用 JSON 格式记录，便于后期分析与监控系统集成
• 敏感信息过滤：避免将用户输入、密码、令牌等写入日志
• 日志轮转：配合 logrotate 或应用层机制防止日志文件过大
• 异常上报服务：集成 Sentry、Monolog 等工具，实现实时告警和堆栈追踪

基本上就这些。只要正确设置顶层异常处理器并结合合理的日志策略，就能有效提升 PHP 应用的稳定性和可维护性。