php在centos上的日志管理技巧

CentOS 上 PHP 日志管理实用技巧

一 日志位置与快速定位

• 常见路径一览：
  • Apache：访问日志 /var/log/httpd/access_log，错误日志 /var/log/httpd/error_log
  • Nginx：访问日志 /var/log/nginx/access.log，错误日志 /var/log/nginx/error.log
  • PHP-FPM：错误日志 /var/log/php-fpm/error.log 或 /run/php-fpm/www-error.log；访问日志（若启用）/var/log/php-fpm/access.log
• 快速定位方法：
  • 查看 Web 服务配置：/etc/httpd/conf/httpd.conf（Apache）、/etc/nginx/nginx.conf（Nginx）
  • 查看 FPM 配置：/etc/php-fpm.d/www.conf
  • 在 PHP 中调用 phpinfo() 查看 error_log 实际路径
  • 命令行检索：
    • 实时查看 FPM 错误日志：tail -f /var/log/php-fpm/error.log
    • 查找包含 error_log 的配置：grep -r “error_log” /etc/php /etc/nginx /etc/httpd*
    • 全盘查找 error_log 文件：sudo find / -type f -name “error_log”

二 核心配置建议

• PHP 运行时日志（php.ini）
  • 建议开启错误日志、关闭页面显示错误，避免泄露敏感信息：
    • error_reporting = E_ALL & ~E_NOTICE
    • log_errors = On
    • error_log = /var/log/php_errors.log
    • display_errors = Off
• PHP-FPM 日志（/etc/php-fpm.d/www.conf）
  • 开启进程输出与 FPM 错误日志，便于定位 Fatal/Parse/Pool 等问题：
    • catch_workers_output = yes
    • php_admin_flag[log_errors] = on
    • php_admin_value[error_log] = /var/log/php-fpm/www-error.log
  • 如启用 FPM 访问日志（便于审计与统计）：
    • access.log = /var/log/php-fpm/access.log
• 应用层日志（业务与框架）
  • 使用 Monolog 等库写入应用日志；高并发场景建议采用异步/缓冲写入，降低 I/O 抖动
• 变更生效
  • 修改 php.ini 后重启 httpd 或 php-fpm
  • 修改 FPM 配置 后重启 php-fpm
    • 重启命令示例：systemctl restart httpd、systemctl restart php-fpm、systemctl restart nginx

三 日志轮转与保留策略

• PHP-FPM 与 PHP 错误日志（logrotate）
  • 创建 /etc/logrotate.d/php-fpm：

    /var/log/php-fpm/*.log /var/log/php_errors.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`
            fi
        endscript
    }
    

  • 说明：
    • daily/rotate 7/compress：按天轮转并保留 7 天
    • create 0640 root adm：新日志权限与属主
    • postrotate + kill -USR2：通知 FPM 重新打开日志文件，避免日志句柄占用
• Web 服务器日志
  • Nginx：使用 logrotate 管理 /var/log/nginx/*.log，在 postrotate 中向 Nginx 主进程发送 USR1 信号以重新打开日志
  • Apache：可使用 rotatelogs 按时间切割（如按天），也可交由 logrotate 管理
• 测试与验证
  • 手动触发轮转并验证：logrotate -f /etc/logrotate.d/php-fpm；检查是否生成 .gz 归档与 FPM 是否正常写入新文件

四 监控 告警与清理

• 实时监控
  • 跟踪最新错误：tail -f /var/log/php-fpm/error.log、tail -f /var/log/nginx/error.log
  • 使用 logwatch 做日常汇总分析：安装 yum install logwatch，按需调整 /etc/logwatch/conf/logwatch.conf
• 容量与清理
  • 定期检查磁盘：df -h、du -sh /var/log/php-fpm /var/log/nginx
  • 自动清理（示例：删除 7 天前 PHP 相关日志）
    • Crontab：0 0 * * * find /var/log/php -type f -name “*.log” -mtime +7 -delete*
• 集中式日志
  • 大规模或分布式环境建议接入 ELK Stack（Elasticsearch, Logstash, Kibana） 或 Graylog，统一采集、检索与可视化分析

五 排错清单与最佳实践

• 权限与路径
  • 确保日志目录（如 /var/log/php-fpm）存在且 php-fpm 运行用户可写；常见权限 0640，属主 root:adm
• 配置生效
  • 修改 php.ini 需重启 httpd/php-fpm；修改 FPM 配置 需重启 php-fpm
• 日志未落盘
  • 确认 log_errors = On 且 error_log 路径可写；FPM 需 catch_workers_output = yes 与 php_admin_flag[log_errors] = on
• 轮转失败
  • 检查 logrotate 配置语法与 postrotate 脚本；确认 PID 文件路径正确并具备发送信号权限；必要时手动执行 logrotate -f 验证
• 安全与性能
  • 生产环境务必 display_errors = Off；按需调整 error_reporting 避免日志风暴；高并发应用优先使用异步日志与集中式日志平台