Debian PHP日志记录哪些信息

Debian系统中PHP日志记录的内容及来源

Debian系统中，PHP日志记录的内容主要取决于日志的来源（PHP自身、PHP-FPM、Web服务器），不同来源的日志记录信息各有侧重，以下是详细分类说明：

一、PHP内置错误日志（核心错误信息）

PHP通过error_log()函数或php.ini配置记录自身运行中的错误，是最基础的日志来源。记录的信息包括：

• 错误级别：如E_ERROR（致命错误，脚本终止）、E_WARNING（运行时警告，脚本继续）、E_PARSE（语法解析错误）、E_NOTICE（轻微提示，如未定义变量）、E_DEBUG（调试信息，需手动开启）等；
• 错误消息：具体的错误描述（如“Call to undefined function”）；
• 文件路径与行号：发生错误的PHP脚本文件及行号（如/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脚本自身的错误，便于开发者排查代码问题。

二、PHP-FPM日志（进程管理与服务状态）

若使用PHP-FPM（FastCGI进程管理器），其日志会记录进程的运行状态、请求处理情况及错误信息，分为两类：

1. 错误日志（error_log）：
   记录PHP-FPM进程的异常信息，内容包括：

   • 进程状态：如子进程启动/退出、平滑重启触发；
   • 错误事件：如子进程因SIGSEGV（段错误）、SIGBUS（总线错误）崩溃，或request_terminate_timeout（请求超时）触发的终止；
   • 资源限制：如内存超出memory_limit的警告；
   • 配置问题：如listen地址绑定失败、权限不足等。

2. 访问日志（access_log，可选）：
   需在php-fpm.conf或进程池配置文件（如/etc/php/{version}/fpm/pool.d/www.conf）中开启，记录客户端对PHP的请求信息，内容包括：

   • 客户端IP（%R）；
   • 请求时间（%t，格式如%d/%b/%Y:%H:%M:%S %z）；
   • 请求方法与URI（%m %r，如GET /index.php?id=1）；
   • 响应状态码（%s，如200、404、500）；
   • 处理时间（%d，单位秒，如0.123）；
   • 内存峰值（%M，如1024KB）；
   • 进程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通过Web服务器（Apache/Nginx）运行，Web服务器会记录与PHP请求相关的日志，可与PHP日志互补，关联请求的完整生命周期：

1. Apache日志：

   • 错误日志（error_log）：记录Apache处理PHP请求时的错误，内容包括：
     • 模块错误：如mod_php加载失败、PHP模块配置错误；
     • 权限问题：如脚本文件无读取权限（403 Forbidden）；
     • CGI/FastCGI错误：如PHP-FPM进程无响应（502 Bad Gateway）。
   • 访问日志（access_log）：记录所有访问请求，内容包括：
     • 客户端IP、请求时间、请求方法与URI、响应状态码、传输字节数等（格式可通过LogFormat指令自定义）。

2. Nginx日志：

   • 错误日志（error_log）：记录Nginx与PHP-FPM通信的错误，内容包括：
     • 连接失败：如PHP-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指令。
  适用场景：关联PHP请求与Web服务器的响应，排查网络、权限或配置层面的问题。

四、自定义日志（业务逻辑日志）

开发者可通过PHP代码使用error_log()函数或第三方日志库（如Monolog）记录自定义业务日志，内容包括：

• 业务事件：如用户注册、订单创建、支付成功等；
• 调试信息：如函数执行时间、变量值（需开启display_errors或写入日志文件）；
• 审计跟踪：如用户登录、权限变更等敏感操作。

示例代码：

// 使用error_log函数记录到指定文件 error_log("User {$username} logged in at " . date('Y-m-d H:i:s'), 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('User logged in', ['username' => $username, 'ip' => $_SERVER['REMOTE_ADDR']]); 

适用场景：记录业务逻辑的关键节点，便于后续审计、分析或排查业务问题。

日志文件的位置

Debian系统中，PHP日志的默认路径通常如下：

• PHP内置错误日志：/var/log/php_errors.log（需通过php.ini配置）；
• PHP-FPM错误日志：/var/log/php-fpm/error.log（主进程日志）；
• PHP-FPM访问日志：/var/log/php-fpm/access.log（需开启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。

注意：日志路径可能因发行版版本或自定义配置而变化，建议通过配置文件确认。