PHP-FPM在Linux下的错误日志怎么查

首页

编程语言

热心网友

转载

2026-05-05

Linux下查看 PHP-FPM 错误日志的实用步骤

PHP-FPM在Linux下的错误日志怎么查

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

一、快速定位日志路径

排查PHP-FPM问题的第一步，是准确找到错误日志的存放位置。这通常需要检查其配置文件。

首先，查看PHP-FPM的进程日志配置。主配置文件通常是 /etc/php-fpm.conf，但更详细的配置往往位于进程池文件中，例如 /etc/php/{版本号}/fpm/pool.d/www.conf。你需要重点关注以下几个指令：error_log（定义错误日志路径）、access.log（访问日志，可选）、slowlog（慢执行日志，可选）以及 log_level（设置日志记录级别）。

如果不方便查看配置文件，也可以直接尝试各Linux发行版的常见默认路径：

Ubuntu/Debian：通常位于 /var/log/php-fpm/error.log 和 /var/log/php-fpm/access.log。
CentOS/RHEL：路径可能是 /var/log/php-fpm/error.log，也可能是类似 /var/log/php7.x-fpm.log 的格式。
其他可能的位置还包括 /var/log/php7-fpm/error.log。

需要注意的是，如果配置文件中未明确设置 error_log，日志可能会被重定向到其他地方。在某些环境下，错误信息可能被记录到系统日志（如 /var/log/syslog），或者直接输出到Web服务器的错误日志中，例如Nginx的 /var/log/nginx/error.log 或Apache的 /var/log/apache2/error.log。当在常规路径找不到日志时，建议检查这些位置。

二、常用查看与检索命令

定位到日志文件后，高效地查看和分析内容是关键。以下是在Linux终端中处理PHP-FPM日志的常用命令。

实时监控错误日志：要动态跟踪最新产生的日志条目，使用：tail -f /var/log/php-fpm/error.log。
查看最近N行记录：快速浏览最新的日志，例如查看最近200行：tail -n 200 /var/log/php-fpm/error.log。
按关键字筛选：使用 grep 命令快速过滤。例如，查找所有包含“error”、“WARNING”或“segfault”的行：grep -i “error” /var/log/php-fpm/error.log。
按时间范围检索：查看特定日期的日志，例如检索2025年12月24日的记录：grep “2025-12-24” /var/log/php-fpm/error.log。
同时跟踪多个日志文件：可以同时监控错误日志和访问日志：tail -f /var/log/php-fpm/*.log。
使用systemd查看服务日志：对于使用systemd管理的服务，直接查看其日志更为便捷：journalctl -u php-fpm -n 50 --no-pager。
检查系统日志：如果错误信息被记录到系统日志，可使用：grep -i “php-fpm” /var/log/syslog。

请注意，大多数日志文件需要 sudo 或 root 权限才能读取，操作时请确保拥有相应权限。

三、启动失败或未写入日志时的排查

当PHP-FPM服务无法启动，或者日志文件没有新内容时，需要按照系统化步骤进行深入排查。

验证配置文件语法：首先检查配置文件是否有语法错误：php-fpm -t 或 php{版本号}-fpm -t。
查看服务状态与近期日志：通过 systemctl status php-fpm 检查服务运行状态，并结合 journalctl -u php-fpm -n 50 --no-pager 查看最近的系统日志信息，这里常包含启动失败的原因。
检查端口或Socket占用：确认PHP-FPM监听的端口（默认9000）或Unix Socket文件未被占用。检查端口：netstat -tulnp | grep 9000。检查Socket文件：ls -l /run/php/php{版本号}-fpm.sock。
检查目录权限：权限问题是常见原因。确保PHP-FPM的运行时目录（如 /run/php-fpm）存在且所属用户/组正确。示例命令：mkdir -p /run/php-fpm && chown -R www-data:www-data /run/php-fpm && chmod 755 /run/php-fpm。同时，也要确保日志目录有写入权限：chown -R www-data:www-data /var/log/php-fpm/。
重启服务：解决上述问题后，重启服务以使更改生效：systemctl restart php-fpm 或 service php{版本号}-fpm restart。

四、补充定位技巧

掌握一些进阶技巧，可以让PHP-FPM日志排查工作更加高效和精准。

区分两种 error_log：注意区分PHP-FPM进程自身的错误日志和PHP解析器的错误日志。后者由 php.ini 中的 error_reporting、log_errors 和 error_log 指令控制。前者记录FPM进程管理事件，后者记录PHP脚本运行时错误。
善用 phpinfo() 函数：在不确定实际生效的配置路径时，可以创建一个包含 phpinfo() 函数的PHP文件并通过浏览器访问，它能清晰地展示所有当前配置，包括 error_log 的实际路径。
利用慢执行日志：如果配置了慢日志（slowlog），它是定位PHP脚本性能瓶颈的利器。使用 tail -f /var/log/php-fpm/slow.log 实时监控，可以找出执行时间超时的脚本及其堆栈信息。