Ubuntu PHP日志中警告信息怎么办

Ubuntu PHP日志警告的定位与修复

一 快速定位与查看日志

• 确认 PHP-FPM 是否运行：sudo systemctl status php7.0-fpm（如未运行：sudo systemctl start php7.0-fpm；开机自启：sudo systemctl enable php7.0-fpm）。
• 实时查看 PHP-FPM 日志：sudo tail -f /var/log/php7.0-fpm.log。
• 如使用 Apache，查看 Web 服务错误日志：sudo tail -f /var/log/apache2/error.log；如使用 Nginx，查看：sudo tail -f /var/log/nginx/error.log。
• 也可直接查看 PHP 错误日志文件（路径因系统与配置而异）：如 /var/log/php/php.log 或 /var/log/php7.0-fpm.log。
• 修改配置后务必重启服务：sudo systemctl restart php7.0-fpm 或 sudo systemctl restart apache2。

二 正确配置以显示与记录警告

• 编辑对应版本的 php.ini（如：/etc/php/7.x/fpm/php.ini 或 /etc/php/7.x/apache2/php.ini）：
  • 开启错误记录：log_errors = On
  • 指定日志文件：error_log = /var/log/php_errors.log（确保目录可写，如属 www-data，可执行：sudo touch /var/log/php_errors.log && sudo chown www-data:www-data /var/log/php_errors.log）
  • 开发环境可临时开启显示：display_errors = On；生产环境建议 Off
  • 报告级别：error_reporting = E_ALL（或 E_ALL & ~E_NOTICE 屏蔽 NOTICE）
• 重启服务使配置生效：sudo systemctl restart php7.0-fpm 或 sudo systemctl restart apache2。

三 常见警告类型与修复要点

• Deprecated：使用了将在未来版本移除的特性或函数。修复：替换为推荐替代方案，并更新依赖。
• Notice：如访问未定义数组索引、使用未初始化变量。修复：在使用前初始化变量、增加存在性判断。
• Warning：潜在问题但不终止脚本，如 Division by zero、调用不存在的函数。修复：增加分母非零校验、确认函数/类存在并已加载。
• Fatal Error：语法错误、调用未定义函数等导致脚本终止。修复：按日志提示的文件与行号更正语法或引入缺失文件/扩展。
• Parse Error：语法错误。修复：检查并修正对应行及其附近的花括号、分号、引号等语法。
• 运行时错误：如内存不足、文件不存在、权限问题。修复：检查系统资源、文件路径与权限、依赖是否安装。

四 实战示例与修复

• 示例警告：Division by zero in /var/www/app.php on line 42
  • 修复思路：在运算前校验分母，抛出业务异常或返回默认值。
  • 代码示例：

    $denominator = (int)($_GET['d'] ?? 0);
    if ($denominator === 0) {
        // 记录到应用日志或触发告警
        trigger_error('Division by zero attempted', E_USER_WARNING);
        $result = null; // 或合理的兜底值
    } else {
        $result = 100 / $denominator;
    }
    

• 示例警告：Call to undefined function mysqli_connect()
  • 修复思路：安装并启用 mysqli 扩展，然后重启服务。
  • 命令示例：sudo apt-get install php-mysql；随后 sudo systemctl restart apache2 或 sudo systemctl restart php7.0-fpm。

五 临时抑制与长期治理

• 临时抑制（不建议长期使用）：在 php.ini 中将报告级别设为 error_reporting = E_ALL & ~E_NOTICE ~E_WARNING，或关闭显示 display_errors = Off；生产环境务必保持 log_errors = On 以便审计。
• 长期治理：
  • 使用 Monolog 等日志库统一记录与分级，便于检索与告警。
  • 借助 Xdebug 进行调用栈与变量状态追踪，加速定位根因。
  • 建立日志轮转与监控（如 logrotate、logwatch/grep 定期扫描），避免磁盘被占满并及时发现异常。