Debian PHP日志记录哪些信息

说到Debian系统里的PHP日志，很多人第一反应就是去翻/var/log/下面那个php_errors.log文件。但实际工作中你会发现，PHP日志的来源比想象的复杂得多——既有PHP自身记录的，也有PHP-FPM进程管理器记录的，还有Web服务器那边顺手记下的。它们各司其职，记录的信息侧重点完全不同。搞清楚这些区别，排查问题才能事半功倍。

一、PHP内置错误日志——脚本层面的“病历本”

这是最基础的日志来源，由PHP解释器自己生成。通过php.ini里的参数来控制，记录的是脚本运行时发生的各种问题，比如：

• 错误级别：E_ERROR（致命错误，脚本直接终止）、E_WARNING（运行时警告，脚本还能继续跑）、E_PARSE（语法解析错误）、E_NOTICE（轻微提示，比如用了未定义的变量）、E_DEBUG（调试信息，需要手动开启）。
• 错误描述：具体的异常内容，比如“Call to undefined function”。
• 文件路径与行号：精确定位到是哪个文件的哪一行出了问题，例如/var/www/html/index.php:25。
• 时间戳：错误发生的具体时间，格式像2025-10-01 14:30:00。

配置方法很简单，找到php.ini（路径通常是/etc/php/{version}/apache2/php.ini或/etc/php/{version}/fpm/php.ini），调整这几个参数：

error_reporting = E_ALL      # 报告所有错误
display_errors = Off         # 生产环境不要直接在浏览器显示错误
log_errors = On              # 开启日志记录
error_log = /var/log/php_errors.log  # 指定日志文件路径

这一层日志主要面向开发者，排查代码本身的逻辑错误时最常用。

二、PHP-FPM日志——进程管理的“体检报告”

如果你用的是PHP-FPM（FastCGI进程管理器），那它的日志会记录进程级别的状态。这部分分为两类：

2.1 错误日志（error_log）

记录PHP-FPM主进程和子进程的异常，比如：

• 子进程启动、退出，或者平滑重启被触发。
• 子进程崩溃，比如收到SIGSEGV（段错误）或SIGBUS（总线错误），或者触发了request_terminate_timeout请求超时被强制终止。
• 资源限制警告，比如内存超出memory_limit。
• 配置问题，比如listen地址绑定失败、权限不够。

2.2 访问日志（access_log，可选）

需要在php-fpm.conf或进程池配置（比如/etc/php/{version}/fpm/pool.d/www.conf）里手动开启。它会记录每个PHP请求的详细信息，包括：

• 客户端IP（%R）
• 请求时间（%t）
• 请求方法与URI（%m %r，例如GET /index.php?id=1）
• 响应状态码（%s，如200、404、500）
• 处理时间（%d，单位秒，比如0.123）
• 内存峰值（%M，单位KB）
• 进程PID（%p）

配置示例：

• 错误日志：在php-fpm.conf中设置error_log = /var/log/php-fpm/error.log。
• 访问日志：在进程池配置中加一行access_log = /var/log/php-fpm/access.log，再开启pm.status_path = /status来查看进程状态。

这一层的日志适合运维和性能调优，当怀疑PHP-FPM进程本身有问题时，它是第一排查对象。

三、Web服务器日志——请求的生命周期全记录

PHP通常不会单独运行，而是挂在Apache或Nginx后面。Web服务器也会记日志，这些日志可以和PHP日志互相印证，拼凑出一次请求的完整画面。

3.1 Apache日志

• 错误日志（error_log）：记录Apache在处理PHP请求时遇到的问题，比如mod_php模块加载失败、脚本文件权限不足（403 Forbidden）、PHP-FPM无响应导致502 Bad Gateway。
• 访问日志（access_log）：记录所有请求，包含客户端IP、时间、URI、状态码、传输字节数等。格式可以通过LogFormat指令自定义。

3.2 Nginx日志

• 错误日志（error_log）：记录Nginx与PHP-FPM通信的异常，比如连接失败（FPM崩溃或端口不通）、请求超时（fastcgi_read_timeout触发）、PHP返回500时的简要信息。
• 访问日志（access_log）：和Apache类似，详细记录请求信息，通过log_format指令自定义。

配置路径：Apache修改/etc/apache2/apache2.conf或虚拟主机配置，设置ErrorLog、CustomLog；Nginx修改/etc/nginx/nginx.conf或服务器块配置，设置error_log、access_log。

这一层日志适合排查网络、权限、配置相关的问题，比如502、504错误，往往需要结合PHP-FPM日志和Web服务器日志一起看。

四、自定义日志——业务逻辑的“航标灯”

除了系统层面的日志，开发者还可以在代码里记录自己的业务日志。常用的方式有两种：

• 直接用PHP内置的error_log()函数：error_log("用户 {$username} 登录", 3, "/var/log/php/custom.log");
• 使用专业的日志库，比如Monolog，可以写得更灵活：

require 'vendor/autoload.php';
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
$log = new Logger('my_app');
$log->pushHandler(new StreamHandler('/var/log/php/business.log', Logger::INFO));
$log->info('用户登录', ['username' => $username, 'ip' => $_SERVER['REMOTE_ADDR']]);

这些日志记录的内容由你定义，比如用户注册、订单创建、支付成功、敏感操作审计等。业务逻辑越复杂，自定义日志的价值就越大。

日志文件的位置

在Debian系统默认配置下，各日志文件的典型路径如下：

• PHP内置错误日志：/var/log/php_errors.log（需手动配置）
• PHP-FPM错误日志：/var/log/php-fpm/error.log
• PHP-FPM访问日志：/var/log/php-fpm/access.log（需手动开启）
• Apache错误日志：/var/log/apache2/error.log
• Apache访问日志：/var/log/apache2/access.log
• Nginx错误日志：/var/log/nginx/error.log
• Nginx访问日志：/var/log/nginx/access.log

当然，实际路径可能因发行版版本或自定义配置而异，最好的办法是直接查看对应的配置文件确认。