php-fpm在Linux中的错误处理机制是什么

php-fpm 在 Linux 的错误处理机制

一 核心机制总览

• 分层日志：主进程/进程池有独立的 FPM 错误日志（记录进程启动、退出、信号、资源等），每个池可再单独配置日志；脚本层有 PHP 错误日志（记录语法、运行时错误）。两类日志配合，便于快速定位问题。
• 进程与请求保护：通过进程管理参数与“优雅重启”策略，在异常（如 SIGSEGV/SIGBUS）或资源异常时隔离问题，避免雪崩。
• 请求级诊断：提供 慢执行日志 与 请求超时终止，将性能瓶颈与卡死脚本从正常流量中剥离。
• 运行时可观测性：内置 状态页（pm.status_path） 与 存活探测（ping.path），便于监控与健康检查。
• 配置校验与热重载：支持配置语法校验与信号/服务方式的热重载，降低变更风险。

二 关键配置与用途

三 日志与排障流程

• 配置与校验
  • 编辑池配置（如：/etc/php/{version}/fpm/pool.d/www.conf），开启或调整：
    • error_log（FPM 日志）、catch_workers_output = yes（捕获脚本输出）
    • request_slowlog_timeout 与 slowlog（慢日志）
    • 必要时在 php.ini 中开启 log_errors、设置 error_log、关闭 display_errors
  • 语法校验：php-fpm{version} -t，无误后重载服务：systemctl reload php{version}-fpm 或发送 SIGUSR2。
• 查看与定位
  • 实时查看 FPM 日志：tail -f /var/log/php{version}-fpm.log 或池级日志文件；
  • 查看脚本错误：到 php.ini 指定的 error_log 路径；
  • 若启动失败，优先检查日志中的语法/权限/资源报错，再复核监听地址与端口占用。
• 常见故障点
  • 配置语法错误、日志目录无写权限、监听端口/Socket 被占用、进程数/句柄数不足等。

四 安全与最佳实践

• 生产环境建议：
  • 关闭前台显示错误：display_errors = Off；开启脚本日志：log_errors = On；为 FPM/PHP 日志设置专用目录与权限，避免泄露源码与敏感信息。
  • 使用 php_admin_flag / php_admin_value 在 pool 配置中设置关键项（如 log_errors、error_log），防止业务代码通过 ini_set 覆盖。
  • 合理设置 request_terminate_timeout 与 request_slowlog_timeout，区分“超时”与“慢查询”，避免误杀正常长任务。
  • 启用 pm.status_path 与 ping.path 时，配合防火墙/访问控制，仅对监控或内网开放。