Linux PHP-FPM日志管理技巧

Linux PHP-FPM日志管理实用技巧

一 定位与查看日志

• 常见路径与命令
  • PHP-FPM错误日志：/var/log/php-fpm/error.log 或 /var/log/php--fpm.log
  • 访问日志：/var/log/php-fpm/access.log 或按池配置为 /var/log/php-fpm/www.access.log
  • 实时查看：tail -f /var/log/php-fpm/*.log
  • 慢执行日志：tail -f /var/log/php-fpm/slow.log（需启用慢日志）
  • 系统服务日志：journalctl -u php-fpm（适用于 systemd 管理的系统）
• 快速排查命令示例
  • 过滤错误与告警：grep -E “error|warning” /var/log/php-fpm/error.log
  • 查看最近100行并持续跟踪：tail -n100 -f /var/log/php-fpm/error.log

二 配置与优化日志输出

• 在 FPM 池配置中启用与定向日志（/etc/php/{version}/fpm/pool.d/www.conf）
  • 建议显式设置：error_log、access.log、slowlog、request_slowlog_timeout
  • 示例：
    • error_log = /var/log/php-fpm/error.log
    • access.log = /var/log/php-fpm/access.log
    • slowlog = /var/log/php-fpm/slow.log
    • request_slowlog_timeout = 5s
  • 在 php.ini 中控制 PHP 自身错误记录
    • log_errors = On
    • error_reporting = E_ALL & ~E_NOTICE
• 调整日志级别与输出策略
  • FPM 全局日志级别：log_level = warning（可选：alert、error、notice、debug）
  • 减少冗余：仅在需要时开启访问日志；生产环境避免记录过多调试信息
  • 子进程输出：catch_workers_output = yes（便于捕获脚本标准输出/错误）
• 进程稳定性相关（可选）
  • emergency_restart_threshold / emergency_restart_interval：在出现指定级别错误达到阈值时自动重启，缓解异常进程堆积

三 日志轮转与清理

• 使用 logrotate 管理 PHP-FPM 日志（/etc/logrotate.d/php-fpm）
  • 基本示例（按日轮转、保留7天、压缩、轮转后通知 FPM 重新打开日志）：
    • /var/log/php-fpm/*.log {
      • daily
      • missingok
      • rotate 7
      • compress
      • notifempty
      • create 0640 root adm
      • sharedscripts
      • postrotate
        • if [ -f /run/php/php-fpm.pid ]; then
          • kill -USR2 cat /run/php/php<version>-fpm.pid
        • fi
      • endscript
    • }
  • 通知方式说明
    • 基于 systemd 的系统可用：systemctl reload php-fpm（无 downtime 重载）
    • 或向 FPM 主进程发送 USR2 信号让其重新打开日志文件
  • 手动测试与定时执行
    • 测试：logrotate -f /etc/logrotate.d/php-fpm
    • 定时：logrotate 通常由 /etc/cron.daily/logrotate 每日自动执行
• 清理策略
  • 配合 find 定期清理超期日志（示例删除7天前）：
    • find /var/log/php-fpm -type f -name “*.gz” -mtime +7 -delete
  • 不建议直接 rm 正在写入的日志，优先使用 logrotate 或 truncate

四 监控与性能优化

• 实时监控与告警
  • 实时 tail 与关键字过滤（如 “PHP Fatal”、“Allowed memory size”）
  • 结合系统日志：journalctl -u php-fpm -f -e（查看最新错误并跟踪）
• 降低日志对性能的影响
  • 合理设置 FPM 与 PHP 的日志级别，避免 debug 级别写入生产
  • 高并发场景可引入异步日志（应用层使用如 Monolog 的处理器/队列），减少 I/O 阻塞
• 关联分析
  • 同时观察 Web 服务器访问/错误日志（Nginx/Apache）与 FPM 错误/慢日志，交叉定位请求生命周期问题

五 安全与合规要点

• 权限最小化
  • 日志目录与文件属主/权限建议：如 create 0640 root adm（或按实际运行用户如 www-data 调整），避免泄露敏感堆栈与请求信息
• 日志保留与合规
  • 依据业务与合规要求设置保留周期（rotate 7/30/90），压缩归档便于审计与回溯
• 审计与追踪
  • 保留慢日志用于性能瓶颈定位；必要时集中到 ELK/Graylog 便于检索与可视化