Linux下php-fpm日志如何查看

Linux下查看PHP-FPM日志的方法

日常排查PHP-FPM故障时，日志永远是最先翻的“黑匣子”。不过很多人第一反应是“日志在哪”，然后开始满世界翻配置文件。其实问题的核心无非三件事：找到日志、看懂日志、用好日志。下面直接上干货，从定位到分析，一条龙讲清楚。

1. 定位PHP-FPM日志文件路径

PHP-FPM的日志路径由配置文件中的error_log（错误日志）和access_log（访问日志）参数决定。默认路径会因为发行版和配置方式不同而有所差异，但大致就那么几个常见位置。

• 常见默认路径：
  • 错误日志：/var/log/php-fpm/error.log、/var/log/php-fpm/www-error.log
  • 访问日志：/var/log/php-fpm/access.log、/var/log/php-fpm/www.access.log
• 通过配置文件查找：编辑PHP-FPM主配置文件（通常为/etc/php-fpm.conf或/etc/php-fpm.d/www.conf），查找error_log或access_log指令，确认实际路径。例如：

cat /etc/php-fpm.d/www.conf | grep "error_log|access_log"

• 系统日志替代：如果没单独配置，日志可能写入系统日志（如Ubuntu的/var/log/syslog、CentOS的/var/log/messages），通过grep过滤一下就行：

grep "php-fpm" /var/log/syslog

2. 使用命令行工具查看日志

• 实时查看最新日志：用tail -f跟踪日志文件的实时更新，特别适合一边复现问题一边看报错：

sudo tail -f /var/log/php-fpm/error.log

• 分页查看完整日志：用less或more逐页翻阅，分析历史记录时最顺手：

sudo less /var/log/php-fpm/error.log

• 搜索特定关键词：grep是日志分析的核心武器，比如搜致命错误或特定IP的访问记录：

sudo grep "fatal error" /var/log/php-fpm/error.log
sudo grep "192.168.1.1" /var/log/php-fpm/access.log

3. 常见日志类型及作用

• 错误日志（error.log）：记录PHP-FPM运行时的错误信息，包括语法错误、进程崩溃、权限问题等——排查故障时第一个要查的就是它。
• 访问日志（access.log）：记录所有PHP请求的详细信息，比如请求时间、URI、响应状态码、执行时间，用来分析流量和性能瓶颈非常直观。
• 慢日志（slow.log，需开启）：记录执行时间超过slowlog_threshold阈值（默认10秒）的脚本，对优化慢查询和卡顿问题特别有用。

4. 日志权限与注意事项

• 权限问题：日志文件通常属于root或www-data用户，普通用户查看时记得加sudo：

sudo cat /var/log/php-fpm/error.log

• 日志轮换：日志文件会越写越大，建议配置logrotate自动归档。比如每天切一次，保留7天，压缩旧日志。示例配置（保存到/etc/logrotate.d/php-fpm）：

/var/log/php-fpm/error.log {
    daily
    missingok
    rotate 7
    compress
    delaycompress
    notifempty
    create 0640 www-data adm
}

执行sudo logrotate -f /etc/logrotate.d/php-fpm可手动触发轮换。

掌握了这些方法，以后遇到PHP-FPM相关的异常，基本就能快速定位到问题根源。日志本身不会骗人，关键是怎么把它用起来。