Debian PHP日志关键信息有哪些

Debian PHP日志关键信息与定位

一 日志来源与存放路径

• PHP错误日志
  • 由php.ini控制：常见路径为**/etc/php/版本号/apache2/php.ini**（Apache SAPI）或**/etc/php/版本号/cli/php.ini**（CLI）。关键配置项：error_reporting、display_errors、log_errors、error_log。生产环境建议display_errors=Off、log_errors=On，将错误写入文件而非页面。
• PHP-FPM日志
  • 服务日志：常见路径**/var/log/php-fpm/error.log**；访问日志：/var/log/php-fpm/access.log。配置位于**/etc/php/版本号/fpm/pool.d/www.conf**，常用指令：php_admin_value[error_log]、php_admin_flag[log_errors]、catch_workers_output。
• Web服务器错误日志
  • Apache：/var/log/apache2/error.log
  • Nginx：/var/log/nginx/error.log
  • 反向代理或FastCGI场景下，PHP-FPM的异常也常由Web服务器错误日志呈现（如FastCGI解析错误、上游超时等）。
• 应用自定义日志
  • 使用**error_log(“msg”, 3, “/path/to/file.log”)**写入应用专属日志，便于与系统日志分离。

二 单条日志的关键字段与解读

• 时间戳：发生时间，便于与代码变更、部署窗口对齐排查。
• 错误级别：如E_ERROR、E_WARNING、E_NOTICE、Parse error等；其中Fatal/Parse会导致脚本终止，Notice/Warning多为提示但需关注累积影响。
• 错误消息：错误的具体描述（如“未定义函数/变量”“语法错误”“连接失败”等）。
• 出错文件与行号：定位到具体文件:行号，是修复的直接入口。
• 典型格式示例
  • PHP错误日志：[2023-10-01 14:23:45] PHP Fatal error: Call to undefined function test_function() in /var/www/html/script.php on line 5
  • Web/FPM日志：包含时间、进程/池名、客户端IP、请求URI、HTTP状态码、上游耗时等字段，用于判断是应用错误还是网关/网络问题。

三 常见错误场景与日志特征

• 语法错误（Parse error）
  • 特征：启动或首次访问即报错，页面空白或500；日志含“Parse error”“syntax error”，并指向首个出错文件与行。
• 致命/运行时错误（Fatal/Error）
  • 特征：脚本中断；日志含“Fatal error”“Call to undefined function”“Class not found”等，伴随file:line。
• 警告与通知（Warning/Notice）
  • 特征：脚本继续运行；如“Undefined variable/index”“Deprecated”。虽不致命，但提示潜在缺陷与未来兼容风险。
• 数据库连接失败
  • 特征：应用日志或PHP-FPM/Web错误日志出现“SQLSTATE[HY000] [2002] Connection refused”“Access denied for user”“Unknown database”等；需联动检查数据库服务状态、网络与防火墙、账号权限。
• 上游/网关错误（常见于Nginx+PHP-FPM）
  • 特征：Nginx错误日志出现“upstream prematurely closed connection”“recv() failed”“504 Gateway Timeout”，多与PHP-FPM进程崩溃、超时、进程耗尽相关。

四 快速定位与排查命令

• 实时查看与检索
  • 实时跟踪：tail -f /var/log/php-fpm/error.log
  • 关键字过滤：grep -i “error|fatal|warning” /var/log/nginx/error.log
  • 统计高频错误：awk ‘{print $5}’ /var/log/php-fpm/error.log | sort | uniq -c | sort -nr | head
• 配置与语法校验
  • 检查php.ini语法：php -l /etc/php/版本号/apache2/php.ini
  • 修改php.ini或FPM池配置后，重启服务：systemctl restart apache2 或 systemctl restart php版本号-fpm
• 日志轮转与健康
  • 使用logrotate管理日志大小与保留份数，配置文件位于**/etc/logrotate.d/**（如php-fpm、apache2、nginx），避免磁盘被撑满。