在 Ubuntu 系统中定位与查看 PHP-FPM 日志
排查 PHP-FPM 的问题,第一步往往就是找到日志。在 Ubuntu 系统里,这些日志通常藏在几个固定的位置,但具体路径可能会因你的 PHP 版本和配置而略有不同。

一般来说,你需要关注两类日志:
- 主错误日志:通常位于
/var/log/php-fpm.log或带版本号的/var/log/php7.x-fpm.log(记得把x替换成你实际使用的版本号)。 - 池(Pool)日志:通常位于
/var/log/php-fpm/pool.d/www.log或对应的版本路径/var/log/php7.x-fpm/pool.d/www.log。
找到了文件,怎么查看呢?Linux 下那几个经典的文本处理命令——cat、tail、less 和 grep——这时候就派上用场了。下面是一些最常用的命令示例,你可以直接复制使用:
- 查看主错误日志的全部内容:
sudo cat /var/log/php-fpm.log
或者,如果你的日志文件带了版本号:
sudo cat /var/log/php7.x-fpm.log
- 实时跟踪主错误日志的最新动态(这在调试时特别有用):
sudo tail -f /var/log/php-fpm.log
或者:
sudo tail -f /var/log/php7.x-fpm.log
- 查看特定进程池的日志内容:
sudo cat /var/log/php-fpm/pool.d/www.log
或者:
sudo cat /var/log/php7.x-fpm/pool.d/www.log
- 实时跟踪进程池日志:
sudo tail -f /var/log/php-fpm/pool.d/www.log
- 在日志中快速搜索特定关键词(比如过滤出所有错误信息):
sudo grep 'ERROR' /var/log/php-fpm.log
或者:
sudo grep 'ERROR' /var/log/php7.x-fpm.log
话说回来,最稳妥的方法还是直接去核对配置文件。因为日志的最终路径是由 error_log 参数决定的。这个配置通常位于 /etc/php/7.x/fpm/pool.d/www.conf 或主配置文件 /etc/php/7.x/fpm/php-fpm.conf 中。打开看一眼,就能确保你找的路径万无一失。
