Ubuntu中如何查看PHP-FPM错误

在Ubuntu系统中排查PHP-FPM问题时，日志文件是我们最常用的工具之一。它会告诉我们问题到底出在哪——是配置错误、权限不足，还是代码本身有异常。下面就来梳理一下查看错误日志的几个实用方法。

1. 搞清楚日志文件到底在哪

可能很多朋友在配置服务器的时候都遇到过这个问题：日志到底在哪？PHP-FPM的错误日志路径随系统配置和PHP版本的不同而有所变化。常见的位置主要有这么几个：

• 默认路径：/var/log/php-fpm.log（Ubuntu下的通用路径），或者类似 /var/log/php7.x-fpm.log（其中 7.x 替换为实际版本号，比如 php8.2-fpm.log）；
• 专用错误日志：部分系统会单独把PHP-FPM的错误记录到 /var/log/php-fpm/error.log；
• 配置文件中确认：最稳妥的办法，是打开PHP-FPM池的配置文件（路径一般是 /etc/php/{version}/fpm/pool.d/www.conf），找到 error_log 参数，比如 error_log = /var/log/php-fpm/error.log，那这里就是真正的日志地址了。

2. 实时盯着日志看

如果是排查正在发生的错误，那用 tail -f 命令最直接，能实时看到日志新增的内容：

sudo tail -f /var/log/php-fpm.log# 默认路径sudo tail -f /var/log/php-fpm/error.log# 专用错误日志路径

注意，如果日志路径里带着版本号（比如 php8.2-fpm.log），记得替换成你实际安装的版本。

3. 翻翻历史日志

想查完整的历史记录，而不是实时更新，可以用这几个命令：

sudo cat /var/log/php-fpm.log# 查看全部内容sudo less /var/log/php-fpm.log # 分页查看（按q退出）sudo grep "error" /var/log/php-fpm.log # 只过滤出错误信息，更精准

其中 grep 命令特别好用，配合 error、warning、fatal 这类关键词，基本能快速定位到问题。

4. 进阶方法：用 journalctl 看系统日志

如果你的PHP-FPM是用 systemd 管理的（Ubuntu默认就是这样），那用 journalctl 查看系统日志会更方便——尤其是在你找不到日志文件路径的时候：

sudo journalctl -xe | grep php-fpm # 实时过滤PHP-FPM错误sudo journalctl -u php7.x-fpm -f # 实时查看指定PHP版本的日志（替换版本号）

这个方法能把系统层面的日志也整合进来，排查问题时视野会更全面。

5. 可选：让日志更详细些

有时默认的日志信息不够用，判断起原因来有点吃力。这时候可以修改PHP-FPM配置，提高日志的详细度：

• 编辑池配置文件（/etc/php/{version}/fpm/pool.d/www.conf），添加或修改这几项参数：

  catch_workers_output = yes # 捕获worker进程输出php_admin_value[error_log] = /var/log/php-fpm/custom_error.log# 自定义日志路径php_admin_flag[log_errors] = on# 开启错误日志php_admin_value[error_reporting] = E_ALL & ~E_NOTICE & ~E_STRICT# 记录所有错误（除提示和严格模式）

• 保存后，重启PHP-FPM服务让配置生效：

  sudo systemctl restart php7.x-fpm# 替换为实际版本

修改之后，错误信息会记录到你指定的 custom_error.log 文件中，后续分析起来就方便多了。

通过以上这几个步骤，基本上可以全面掌握Ubuntu系统中PHP-FPM的错误日志查看方法，快速找到问题根源。无论是配置错误、权限问题还是代码异常，日志都会给出线索。