PHP 错误与异常的日志记录实战：环境排查与代码捕获

理解错误（Error）与异常（Exception）

在编写可维护的代码前，首先需要明确“错误”与“异常”在 PHP 层面的本质区别。

• 错误（Error）：如变量未定义、除以零等属于系统级的逻辑违规。这类事件通常表现为 Warning 或 Fatal Error，默认情况下它们不会被常规的 try-catch 块直接捕获（除非配合 ErrorHandler）。
• 异常（Exception）：是应用程序逻辑层面的问题（如数据库连接失败），通过代码主动抛出，可以通过标准的 try-catch 结构进行流控和处理。

Nginx + PHP 环境的日志排查顺序

在实际的 Nginx + PHP-FPM 环境中，日志分散在不同层级的配置文件中。当系统出现故障时，建议遵循以下查找路径：

1. Nginx Access Log：首先检查请求是否到达服务端，确认 HTTP 状态码（如返回 404 或 502）。
2. PHP-FPM Logs：检查 PHP 进程的启动、终止记录以及慢查询日志，用于判断进程是否因为底层扩展或核心崩溃而重启。
3. PHP & Nginx Error Log：如果 php.ini 中配置的日志位置不可写，或者未指定具体路径，部分错误会被转发至 nginx/error.log。

第1步：检查 PHP 日志的配置项

确保 PHP 自身的日志功能已开启，主要涉及 php.ini 中的两个关键参数：

error_log = /var/log/php-fpm/error.log  ; 指定日志文件路径
log_errors = On                       ; 开启错误日志记录

此外还需核对 php-fpm.conf，查看是否设置了慢执行日志（slowlog）及对应的阈值参数 request_slowlog_timeout。

第2步：验证日志写入权限与流向

如果在配置了 php-fpm 的 error log 后依然看不到日志，可能是因为目标目录没有写入权限。此时，请转而查看 Nginx 的 error.log，很多被代理或 CGI 模式下产生的致命错误会在这里留下痕迹。

利用代码层捕捉与记录异常

虽然环境日志能记录系统崩溃，但框架业务层的异常（如逻辑校验失败）需要更精细的记录方式。PHP 提供了两个强大的函数来接管程序退出前的最后操作。

使用 set_exception_handler 全局捕获

通过注册一个全局异常处理器，可以拦截所有未被 try-catch 处理的异常，并将其统一记录到文件或数据库中。

<?php
/**
 * 全局异常捕获示例
 */
function exceptionHandler($exception) {
    // 将异常信息写入专门的日志文件
    $logMessage = "[Uncaught Exception] Code: {$exception->getCode()}, Message: {$exception->getMessage()}, File: {$exception->getFile()}:${exception->getLine()}";
    file_put_contents('/var/log/app_exceptions.log', date('Y-m-d H:i:s') . ' ' . $logMessage . PHP_EOL, FILE_APPEND);
    echo 'An unexpected error occurred.';
}

// 注册该处理器
set_exception_handler('exceptionHandler');

// 触发一个测试异常
echo '准备触发异常...';
throw new Exception('这是一个测试数据');
?>

进阶：使用 Monolog 库进行结构化记录

对于生产环境，强烈建议使用符合 PSR-3 标准的日志库 Monolog。它支持多通道输出（File, Syslog, Database 等）以及日志分级（Info, Warning, Error, Critical）。

接入步骤：

1. 引入 Composer 包：composer require monolog/monolog。
2. 实例化 Logger 并绑定 RotatingFileHandler。
3. 调用 $logger->error() 记录异常。

常见环境与版本陷阱

在处理日志和错误时，PHP 的版本特性至关重要：

• PHP 5.x 时代：诸如 DivisionByZeroError 类的错误无法被传统的 catch(Exception $e) 捕获。如果遇到除以零报错导致脚本中断，需改用 set_error_handler 或将错误转为异常。
• PHP 7.0+ 改进：PHP 7 引入了新的 Error 层级体系（包括 Fatal Error）。虽然大部分警告仍保持兼容，但像求余运算导致的除零错误现在已经可以被 DivisionByZeroError 精确捕获。

总结

建立清晰的 PHP 错误与异常日志记录机制，不仅能降低线上故障的定位时间，还能通过规范化输出为后续的性能优化提供依据。掌握 set_exception_handler 结合专业库的使用，是现代 PHP 开发者的必备技能。

以上就是PHP中错误与异常的日志记录用法的详细内容，更多关于PHP异常处理与日志排查的资料请关注本站其它相关文章！