CentOS PHP日志中的错误追踪方法

CentOS PHP日志错误追踪方法

一 定位日志文件

• 先确认 PHP 运行形态（PHP-FPM 或 Apache 模块），再到对应目录查看日志。常见路径与用途如下：

• 不确定日志位置时，先定位 php.ini：执行 php --ini；在 php.ini 中查找 error_log 配置项，即可知道错误日志文件路径。也可在 /etc/php.d/ 目录下的扩展配置中查找相关设置。

二 查看与分析日志

• 实时查看与检索
  • 实时跟踪 FPM 错误：sudo tail -f /var/log/php-fpm/error.log
  • 检索关键字：sudo grep -i “error” /var/log/php-fpm/error.log
  • 查看 FPM 服务日志：journalctl -u php-fpm -f
• 分析要点
  • 关注日志中的错误类型（如 Parse error、Fatal error、Warning）、出错文件与行号、调用栈/backtrace、请求 URI/脚本路径、时间等字段，先定位到具体文件与行，再回溯触发路径。

三 确保错误被记录

• 在 php.ini 中开启并正确配置：
  • error_reporting = E_ALL
  • log_errors = On
  • display_errors = Off（生产环境建议关闭页面显示，仅写入日志）
  • error_log = /var/log/php_errors.log（确保目录与文件对 PHP-FPM/Apache 进程可写）
• 如使用 PHP-FPM，还需在池配置（如 /etc/php-fpm.d/www.conf 或 php-fpm.conf）中确认 error_log 路径与级别，避免与 php.ini 不一致。
• 修改后重启服务使配置生效：
  • FPM：sudo systemctl restart php-fpm
  • Apache：sudo systemctl restart httpd
  • Nginx：sudo systemctl restart nginx
• 若仍无日志，检查日志目录权限、SELinux 策略与磁盘空间。

四 按场景快速排查

• 页面空白或 500 错误
  • 先看 /var/log/php-fpm/error.log 或 /var/log/httpd/error_log 的最新错误；若涉及数据库/缓存，确认网络与凭据；必要时临时将 display_errors = On 于开发环境定位问题。
• 接口偶发超时或 502/504
  • 查看 Nginx error.log 的 upstream 超时与连接拒绝；结合 php-fpm error.log 与 journalctl -u php-fpm 检查进程存活、慢请求与资源瓶颈。
• CLI 脚本报错
  • 直接运行脚本观察输出；或在命令中指定日志：php -d error_log=/var/log/php_cli.log your_script.php；CLI 模式下错误默认输出到stderr，也可在脚本中用 ini_set(‘error_log’, ‘/path/php_cli.log’) 指定文件。

五 日志轮转与长期追踪

• 使用 logrotate 管理日志大小与保留周期，避免磁盘被占满；对 /var/log/php-fpm/、/var/log/php_errors.log 等设置按日/按大小轮转与压缩。
• 建立关键告警（如 Fatal error、Parse error、频繁 5xx、磁盘告警），并结合 Logwatch/Graylog 做聚合分析与可视化，便于长期追踪与复盘。