在Ubuntu环境下管理PHP-FPM日志,是运维人员必须掌握的核心任务之一。掌握几个关键技巧,能让问题排查效率翻倍,同时避免日志文件过度膨胀占用磁盘空间。下面直接进入正题。

1. 定位PHP-FPM日志文件
日志文件存放的位置取决于安装方式与具体配置。常见路径包括以下几种:
- 默认错误日志:
/var/log/php-fpm.log或/var/log/php7.x-fpm.log(x为PHP版本号,例如7.4、8.1); - 池特定错误日志:若使用了
www.conf池配置,路径通常为/var/log/php-fpm.d/www-error.log; - 访问日志:默认可能不存在,需手动启用,路径类似
/var/log/php-fpm/access.log。
要确认具体路径,直接查看配置文件/etc/php/{version}/fpm/pool.d/www.conf(将{version}替换为实际PHP版本)。关键配置项包括error_log(错误日志)和access.log(访问日志)。
2. 查看与过滤日志内容
- 实时查看日志:使用
tail -f命令监控日志更新——sudo tail -f /var/log/php-fpm/error.log,出现问题时可以立即发现。 - 过滤特定日志:
grep非常实用。查找错误可执行grep "error" /var/log/php-fpm/error.log,查看警告则改用grep "warning"。 - 清空日志文件:当日志过大时,使用
truncate快速清空,例如sudo truncate -s 0 /var/log/php-fpm/error.log,注意是截断而非删除文件。
3. 配置日志级别与输出
- 修改错误日志路径:编辑
/etc/php/{version}/fpm/pool.d/www.conf,去掉error_log前的分号,设置新路径,例如error_log = /var/log/php-fpm/error.log。 - 捕获工作进程输出:将
catch_workers_output设为yes,这样工作进程的标准输出(如PHP错误)才会被记录到错误日志,否则可能静默丢失。 - 调整日志级别:通过
php_admin_value[error_log]可设置级别(如error、warning),生产环境建议设置为error,从而减少无用日志,降低磁盘I/O负载。
4. 实现日志轮转(Logrotate)
日志轮转是防止日志撑爆磁盘的标准做法。Ubuntu默认安装了logrotate,省去不少麻烦。
- 创建配置文件:在
/etc/logrotate.d/下新建php-fpm文件,内容参考如下(路径根据实际情况调整):
/var/log/php-fpm/*.log {
daily
missingok
rotate 7
compress
notifempty
create 0640 www-data adm
sharedscripts
postrotate
if [ -f /run/php/php7.4-fpm.pid ]; then
kill -USR2 `cat /run/php/php7.4-fpm.pid`
fi
endscript
}
- 测试配置:手动触发轮转验证——
sudo logrotate -f /etc/logrotate.d/php-fpm,没有问题即可让其自动运行。 - 自动执行:
logrotate默认通过cron.daily每天凌晨执行,无需额外配置。
5. 分析与优化日志
- 定期检查日志:使用
tail、less等工具快速浏览,重点关注error、warning级别的信息,通常能快速定位代码或配置问题。 - 优化日志配置:根据服务器负载调整日志级别(例如生产环境只保留
error),如果不需要记录所有请求,可直接关闭访问日志。 - 使用第三方工具:复杂场景下可考虑
Monolog等PHP日志库,支持文件、数据库、邮件等多处理器,灵活性更高。
