PHP-FPM在Linux下的日志管理方法

PHP-FPM 在 Linux 下的日志管理方法

一 日志位置与实时查看

• 常见路径与命令
  • PHP-FPM 错误日志：通常位于 /var/log/php-fpm/error.log；访问日志（若启用）位于 /var/log/php-fpm/access.log。实时查看可用：sudo tail -f /var/log/php-fpm/error.log。在 Ubuntu/Debian 上常见日志目录为 /var/log/php-fpm/；在 CentOS/RHEL 上常见为 /var/log/php-fpm/（具体以实际配置为准）。
  • 若通过 systemd 管理 PHP-FPM，可用：sudo journalctl -u php-fpm -f 实时查看服务日志。
  • Web 服务器相关日志（便于联合排查）：Nginx 访问/错误日志在 /var/log/nginx/access.log、/var/log/nginx/error.log；Apache 在 /var/log/httpd/access_log、/var/log/httpd/error_log。

二 日志轮转与保留策略

• 使用 logrotate 管理 PHP-FPM 日志（推荐）
  • 创建或编辑配置文件 /etc/logrotate.d/php-fpm，示例（按日轮转、保留 7 天、压缩、空文件不轮转）：

    /var/log/php-fpm/*.log {
        daily
        missingok
        rotate 7
        compress
        notifempty
        create 0640 root adm
        sharedscripts
        postrotate
            if [ -f /var/run/php-fpm/php-fpm.pid ]; then
                kill -USR2 `cat /var/run/php-fpm/php-fpm.pid` 2>/dev/null || true
            fi
        endscript
    }
    

  • 关键说明
    • 轮转后通知 PHP-FPM 重新打开日志文件：发送 USR2 信号（平滑重启日志句柄）。
    • sharedscripts 确保同组内多个日志文件仅执行一次 postrotate。
    • create 0640 root adm 设置新日志权限与属主属组，需与系统实际用户组匹配（见下一节）。
  • 手动测试与生效验证
    • 测试：sudo logrotate -f /etc/logrotate.d/php-fpm
    • 查看状态：cat /var/lib/logrotate/status
    • 观察是否生成如 error.log-YYYYMMDD.gz 的归档文件。

三 日志级别与输出目标配置

• 在 PHP-FPM 池配置（如 /etc/php-fpm.d/www.conf 或 /etc/php-fpm.conf）中建议明确：
  • 启用并指向错误日志：error_log = /var/log/php-fpm/error.log
  • 启用访问日志（可选）：access.log = /var/log/php-fpm/access.log
  • 捕获工作进程输出：catch_workers_output = yes
  • 使用 php_admin_value[error_log]、php_admin_flag[log_errors] 等指令在池级强制生效（避免被 php.ini 覆盖）。
• 在 php.ini（针对应用错误日志）中可设置：
  • error_reporting = E_ALL & ~E_NOTICE
  • log_errors = On
  • error_log = /var/log/php_errors.log（如希望与应用错误分离）。
• 修改后重载或重启服务：sudo systemctl reload php-fpm（或 restart）。

四 权限与路径适配

• 路径与用户组需与实际环境一致：
  • Debian/Ubuntu 常见运行用户为 www-data，logrotate 中 create 建议使用 www-data adm。
  • CentOS/RHEL 常见运行用户为 apache 或 nginx，logrotate 中 create 建议使用 root adm 或与运行用户匹配的组。
• 若 php-fpm.pid 路径不同（如 /run/php-fpm.pid 或 /var/run/php-fpm.pid），需相应调整 logrotate 的 postrotate 脚本。

五 监控分析与清理

• 实时监控与排查
  • 实时查看：tail -f /var/log/php-fpm/*.log、journalctl -u php-fpm -f
  • 关键字检索：grep -i "error\|warning" /var/log/php-fpm/error.log
• 集中化与长期分析
  • 使用 ELK Stack（Elasticsearch, Logstash, Kibana） 或 Graylog 收集、检索与可视化日志。
  • 使用 rsyslog/syslog-ng 将日志转发到远程日志服务器，便于统一审计与归档。
• 清理与容量控制
  • 以 logrotate 的 rotate 与 compress 为主，必要时可辅以定时清理旧归档（如 find ... -mtime +N -delete），避免重复清理策略。