php如何捕获所有未处理异常_php设置顶层异常处理器与日志记录策略

通过set_exception_handler()设置全局异常处理器,捕获未处理异常并记录日志,同时结合set_error_handler()将运行时错误转为异常统一处理,避免程序崩溃暴露敏感信息。

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 "

系统繁忙,请稍后再试

"; } } // 注册处理器 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 应用的稳定性和可维护性。