Ubuntu PHP错误日志怎么分析

Ubuntu PHP错误日志定位与分析

一 先找到日志文件位置

• 使用 php.ini 查找：打开对应 SAPI 的配置文件（如 /etc/php/8.1/apache2/php.ini 或 /etc/php/8.1/fpm/php.ini），搜索 error_log 指令即可看到日志完整路径。也可用命令快速定位配置文件与日志路径：
  • 查看已加载配置：php -i | grep ‘Loaded Configuration File’
  • 直接查 error_log：grep -i error_log /etc/php//apache2/php.ini /etc/php//fpm/php.ini
• 若未设置专用 PHP 错误日志，PHP 错误常写入 Web 服务器错误日志：
  • Apache：/var/log/apache2/error.log
  • Nginx：/var/log/nginx/error.log
• 使用 PHP-FPM 时，常见路径为：/var/log/php7.x-fpm.log 或 /var/log/php-fpm.log（版本号以实际为准）。
• 也可在页面输出 phpinfo() 并搜索 error_log 查看路径。

二 实时查看与初步筛选

• 实时跟踪最新错误：
  • 跟踪 PHP-FPM 日志：sudo tail -f /var/log/php7.4-fpm.log
  • 跟踪 Web 服务错误日志：sudo tail -f /var/log/apache2/error.log 或 sudo tail -f /var/log/nginx/error.log
• 关键字筛选：
  • 按级别筛选：grep -i “error|warning|notice” /var/log/php7.4-fpm.log
  • 按时间或文件定位：*grep -n "2025-12-12.my_script.php" /var/log/php7.4-fpm.log
• 统计与去重：
  • 统计错误级别数量：grep -E ‘error|warning|notice’ /var/log/php/error.log | wc -l
  • 找出重复报错：grep ‘SQLSTATE[42S22]’ /var/log/php/error.log | sort | uniq -c | sort -nr
• 如需更友好的日报，可用 logwatch 生成分析报告。

三 读懂日志结构与定位要点

• 典型 PHP 错误日志条目包含：时间戳、错误级别（如 Fatal error、Parse error、Warning）、错误消息、出错文件与行号、以及可选的 堆栈跟踪（Stack trace）。例如：
  • [01-Sep-2023 12:34:56] PHP Fatal error: Uncaught Error: Call to undefined function foo() in /var/www/my_script.php:12
• 定位步骤：
  1. 从时间戳确定发生时间；2) 用错误级别判断紧急程度（Fatal/Parse 需立刻处理）；3) 按“文件:行号”打开源码核查；4) 有堆栈时自底向上追踪调用链；5) 若日志仅显示 “File not found” 或 “Permission denied”，同时检查 Web 服务器错误日志与 文件系统权限。

四 配置与排查清单

• 关键 php.ini 设置（开发/生产建议不同）：
  • 开发：display_errors = On、log_errors = On、error_reporting = E_ALL
  • 生产：display_errors = Off、log_errors = On、error_reporting = E_ALL（避免泄露敏感信息）
• 修改后重启服务使生效：
  • Apache：sudo systemctl restart apache2
  • PHP-FPM：sudo systemctl restart php8.1-fpm（版本号以实际为准）
• 仍找不到日志或无新日志时：
  • 再次确认 error_log 路径与 log_errors = On；
  • 检查 PHP-FPM 池配置（如 /etc/php/8.1/fpm/pool.d/www.conf）是否单独设置了 error_log；
  • 查看 /var/log/syslog 获取进程启动失败等系统级线索。

五 高效分析命令速查表