Ubuntu PHP日志报错怎么办

Ubuntu PHP日志报错排查与修复

一 快速定位日志位置

• 先确认当前运行的 SAPI（Apache 模块、PHP-FPM、CLI），不同 SAPI 读取的 php.ini 可能不同。
• 查看加载的配置与错误日志路径：
  • 查看配置：运行 php --ini；Web 环境可用 phpinfo() 查看实际加载的配置文件与 error_log 值。
• 常见日志路径与命令：
  • Apache：日志在 /var/log/apache2/error.log；实时查看：sudo tail -f /var/log/apache2/error.log
  • Nginx：错误日志 /var/log/nginx/error.log；PHP-FPM 常见在 /var/log/php-fpm/error.log 或 /var/log/php7.x-fpm.log（x 为版本号）；实时查看：sudo tail -f /var/log/nginx/error.log 或 sudo tail -f /var/log/php-fpm/error.log
• 若使用 PHP-FPM，还需检查对应池配置（如 /etc/php/{version}/fpm/pool.d/www.conf）是否覆盖了日志设置。

二 让 PHP 正确写入错误日志

• 在正确的 php.ini（Web 用 SAPI 的那个）中设置：
  • log_errors = On（开启写入日志）
  • error_log = /var/log/php_errors.log（自定义日志文件路径）
  • error_reporting = E_ALL（记录所有错误；生产环境可配合调整）
  • 生产建议：display_errors = Off（不在页面暴露错误），开发环境可临时开启便于调试
• 若使用 PHP-FPM，确保池配置未覆盖上述设置；必要时在 www.conf 中使用如 php_admin_value[error_log] 明确指定。
• 修改后重启服务：
  • Apache：sudo systemctl restart apache2
  • Nginx + PHP-FPM：sudo systemctl restart php{version}-fpm && sudo systemctl restart nginx
• 验证配置是否生效：
  • CLI：运行 php -i | grep -E ‘error_log|log_errors|error_reporting’
  • Web：访问 phpinfo() 页面核对相同项

三 权限与路径问题排查

• 确认日志目录与文件存在且可写：
  • 创建目录（示例）：sudo mkdir -p /var/log/php
  • 设定归属（以 www-data 为例）：sudo chown www-data:www-data /var/log/php_errors.log
  • 设定权限：sudo chmod 664 /var/log/php_errors.log
• 若仍无日志：
  • 检查 open_basedir、磁盘空间、日志轮转（logrotate）是否压缩或清理了当前文件。
  • 确保运行 PHP 的用户（如 www-data）对日志目录具有写权限。

四 用最小脚本验证与常见修复

• 创建测试脚本 /var/www/html/test_error.php：

  <?php
  error_reporting(E_ALL);
  ini_set('log_errors', 1);
  ini_set('display_errors', 0); // 生产建议关闭
  ini_set('error_log', '/var/log/php_errors.log');
  
  // 触发一个可记录的错误
  echo $undefined_var;
  

• 通过浏览器访问该脚本，然后实时查看日志：sudo tail -f /var/log/php_errors.log。若仍无输出，回到第二节核对 SAPI、配置与权限。
• 常见修复动作：
  • 配置错误：修正 php.ini 后重启服务（Apache 或 PHP-FPM）。
  • 扩展缺失：安装所需扩展，例如 sudo apt-get install php-mysqli。
  • 服务未启动：检查并启动对应服务（如 sudo systemctl start php{version}-fpm）。
  • 代码问题：依据日志定位文件与行号，修复语法/调用/权限等问题。