罗罗编程学习记录
本页内容 展开查看

06.5.8.10 Nginx 与 FPM 协作

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.8 PHP 配套技术栈

06.5.8.10-001 一个 PHP 请求从浏览器到返回经过哪些环节?

一句话结论

链路为浏览器请求 → Nginx 监听匹配 location → 静态资源直接返回;PHP 请求通过 FastCGI 协议转发到 php-fpm 进程 → FPM 拉起 PHP 解释执行脚本 → 响应按 FastCGI 回传 Nginx → Nginx 组装 HTTP 响应返回客户端。

概念解释

Nginx 不直接解释 PHP,它作为 HTTP 入口与反向代理,负责连接管理、静态资源、限流与转发;php-fpm 是 FastCGI 进程管理器,维护 PHP worker 进程池。两者通过 FastCGI 协议(Unix socket 或 TCP)通信。脚本路径、文档根目录、请求方法、查询串等通过 FastCGI 参数传递。

原理流程

  1. Nginx 接收 HTTP 请求,按 server_name 与 location 规则匹配。
  2. 静态文件命中则由 Nginx 读文件并设置缓存头直接返回。
  3. .php 请求构造 FastCGI 参数,转发到 FPM 监听地址。
  4. FPM 选择空闲 worker 执行 PHP,输出回传 Nginx,Nginx 补齐响应头后返回客户端。

代码或图示

// 文档示例:典型 Nginx + FPM 转发配置(配置写在 nginx.conf / 站点配置中)
// location ~ \.php$ {
//     fastcgi_pass 127.0.0.1:9000;
//     fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
//     include fastcgi_params;
// }
// PHP 侧只看到 $_SERVER 中由参数注入的脚本名、请求方法与查询串

常见误区

  • 以为 Nginx 内嵌 PHP 解释器:Nginx 只做转发,PHP 执行完全在 FPM 进程内。
  • 把 FPM 当成 Web 服务器:FPM 只说 FastCGI,不能直接接收浏览器 HTTP 请求。

追问

  • 通信能用 Unix socket 吗?答:可以,同机部署常用 socket 减少 TCP 开销;跨机部署只能用 TCP。
  • 请求体在哪里缓冲?答:Nginx 先接收并缓冲请求体,再转发给 FPM;大上传受 client_max_body_size 控制。

06.5.8.10-002 Nginx location 匹配优先级是怎样的?

一句话结论

匹配顺序为精确匹配 = 优先,其次前缀匹配(最长前缀与 ^~ 修饰),再按配置顺序匹配正则 ~/~*,最后落到普通前缀;配置不当会导致 PHP 请求被静态规则截走或漏转 FPM。

概念解释

= 精确命中立即停止;^~ 前缀命中后不再检查正则;正则按书写顺序匹配,先命中先生效;普通前缀作为兜底。静态资源与 PHP 脚本的 location 要分别覆盖,避免 .php 请求落到静态目录规则下返回源码或 404。

原理流程

  1. 先找 = 精确匹配,命中即使用。
  2. 记录所有前缀匹配中的最长前缀;若最长前缀带 ^~,停止正则检查。
  3. 否则按配置文件顺序检查正则,命中即用。
  4. 正则都不命中则使用最长普通前缀。

代码或图示

// 文档示例:站点 location 划分
// location = /healthz { return 200 'ok'; }          # 精确匹配
// location ^~ /static/ { root /var/www/assets; }  # 前缀优先,不再走正则
// location ~ \.php$ { fastcgi_pass fpm:9000; }     # 正则转发 FPM
// location / { try_files $uri $uri/ /index.php?$query_string; } # 前端路由兜底

常见误区

  • 正则 location 顺序随意放:靠前的正则先命中,可能截走本该由其他规则处理的路径。
  • 静态目录规则漏掉 PHP 防护:静态目录内上传的 .php 文件若可被解析,存在执行风险。

追问

  • try_files 起什么作用?答:按候选路径依次检查文件是否存在,最后一项可内部转发到后端脚本或路由。
  • 前端 SPA 路由怎么配?答:文件不存在时转发到入口脚本 index.php 或前端静态首页,由路由层处理。

06.5.8.10-003 fastcgi 转发必须配置哪些关键参数?

一句话结论

核心参数是 SCRIPT_FILENAME(要执行的脚本绝对路径)与 DOCUMENT_ROOT,配合 REQUEST_METHOD、QUERY_STRING、PATH_INFO、CONTENT_TYPE、CONTENT_LENGTH 等;参数缺失会导致 FPM 找不到脚本或 $_SERVER 信息不全。

概念解释

FastCGI 参数是 Nginx 注入到 PHP $_SERVER 的环境变量。SCRIPT_FILENAME 决定 FPM 打开哪个脚本,路径拼错是 502/404 的常见原因。fastcgi_params 基础文件提供通用参数,业务站点按需追加 SCRIPT_FILENAME 等。参数名大小写与 PHP 超全局对应关系需按 FastCGI 约定核对。

原理流程

  1. Nginx 读取请求方法、查询串、请求头与请求体元信息。
  2. 拼接脚本绝对路径 $document_root$fastcgi_script_name 作为 SCRIPT_FILENAME。
  3. 注入内容类型、内容长度等参数后转发 FPM。
  4. FPM 按参数定位脚本,PHP 从 $_SERVER 读取这些变量。

代码或图示

// 文档示例:关键 fastcgi 参数
// fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
// fastcgi_param  DOCUMENT_ROOT      $document_root;
// fastcgi_param  REQUEST_METHOD     $request_method;
// fastcgi_param  QUERY_STRING       $query_string;
// fastcgi_param  PATH_INFO          $fastcgi_path_info;
// fastcgi_param  CONTENT_TYPE       $content_type;
// fastcgi_param  CONTENT_LENGTH     $content_length;

常见误区

  • SCRIPT_FILENAME 写成相对路径:FPM 工作目录不同会找不到脚本,必须给绝对路径。
  • 复制旧配置漏改 DOCUMENT_ROOT:脚本路径与实际部署目录不一致,返回 404 或错误脚本。

追问

  • SCRIPT_NAME 与 SCRIPT_FILENAME 区别?答:前者是脚本路径名,后者是磁盘绝对路径;FPM 执行依赖后者。
  • 环境变量怎么传给 PHP?答:通过 fastcgi_param 或 FPM 进程环境注入;敏感配置走环境变量与配置文件,不写死在站点配置里。

06.5.8.10-004 Nginx 与 FPM 之间的超时链如何配合?

一句话结论

超时链包含 Nginx 到 FPM 的连接超时、读超时、发送超时,以及 FPM 自身的 request_terminate_timeout 与 PHP max_execution_time;各层超时要逐层合理设置,避免外层先断而 PHP 仍在跑,或内层先杀导致响应丢失。

概念解释

fastcgi_connect_timeout 控制连接 FPM 等待;fastcgi_read_timeout 等待 FPM 响应输出;fastcgi_send_timeout 向 FPM 发送请求超时。FPM request_terminate_timeout 到点终止 worker;PHP max_execution_time 限制脚本执行时间。外层超时小于内层时,Nginx 先返回 504 但 PHP 进程仍可能继续执行。

原理流程

  1. 估算接口正常耗时与最慢下游耗时,确定脚本执行上限。
  2. PHP max_execution_time 设为业务可接受上限,FPM 终止时间略高于或对齐。
  3. Nginx 读超时大于 FPM 处理上限,避免 Nginx 先误判。
  4. 超时后逐层记录日志,区分是连接不上、响应过慢还是脚本被终止。

代码或图示

// 文档示例:超时配置方向(具体数值按业务压测确定,默认值待确认)
// fastcgi_connect_timeout 3s;   // 连不上 FPM 快速失败
// fastcgi_read_timeout 60s;     // 等待 FPM 输出
// php.ini: max_execution_time = 30
// fpm.conf: request_terminate_timeout = 35
// 注意:读超时是两次输出之间的等待,不是脚本总时长,行为以版本为准

常见误区

  • 三层超时随意复制:Nginx 超时比 PHP 短,客户端已 504,后端还在写库,造成重复提交。
  • 把 max_execution_time 当成总墙钟时间:它统计脚本 CPU 执行时间,sleep 等等待行为与版本实现有关,待确认。

追问

  • 长任务为什么不在 PHP-FPM 里跑?答:FPM worker 被长任务占用会耗尽进程池;长任务应投递到异步消费者或队列后台执行。
  • 超时后 worker 状态怎么看?答:FPM status 页查看活跃/空闲进程与慢日志,确认是否有进程被终止或卡住。

06.5.8.10-005 FastCGI 缓冲区如何影响大响应与 502?

一句话结论

fastcgi_buffer_size 与 fastcgi_buffers 控制 Nginx 缓冲 FPM 响应的块数与单块大小;响应头与首块走 buffer_size,响应体走 buffers;缓冲区不足时 Nginx 会临时写磁盘,极端配置下可能出现 502 或响应异常。

概念解释

Nginx 默认先缓冲 FPM 响应再发给客户端,降低 worker 被慢客户端拖住的风险。缓冲区数量与大小按典型响应体估算;响应过大超过缓冲会上临时文件。fastcgi_busy_buffers_size 控制已发送给客户端的缓冲上限。大响应(导出报表、大 JSON)要单独评估缓冲与超时配置。

原理流程

  1. 统计典型接口响应体大小分布,确定 buffers 块数与块大小。
  2. 响应头与首行占用 buffer_size;后续响应体分配 buffers。
  3. 缓冲写满后按 busy 阈值边发边缓冲,超出部分落临时目录。
  4. 大文件下载不缓冲进内存,应走静态文件或分片下载链路。

代码或图示

// 文档示例:缓冲配置方向(数值按响应体大小压测确定,待确认)
// fastcgi_buffer_size 16k;
// fastcgi_buffers 8 16k;
// fastcgi_busy_buffers_size 32k;
// 导出类大响应:避免一次性缓冲全量,改为流式输出或异步生成后下载

常见误区

  • 缓冲配置过小又遇大响应:频繁落盘临时文件,延迟升高;配置过大则内存占用上升。
  • 混淆代理缓冲与 FastCGI 缓冲:两者参数前缀不同,作用对象分别是后端 HTTP 服务与 FPM。

追问

  • 关闭缓冲会怎样?答:Nginx 边收边发,慢客户端直接拖住 FPM worker;一般只对 SSE/流式响应考虑关闭。
  • 临时目录权限不足会报错吗?答:会出现写临时文件失败的错误,需核对 Nginx 运行用户对临时目录的权限。

06.5.8.10-006 502 Bad Gateway 常见归因有哪些,怎么逐项排除?

一句话结论

502 表示 Nginx 从 FPM 拿到无效或无响应,常见原因:FPM 未启动/地址端口错误、进程池耗尽、脚本路径错误、FastCGI 协议不匹配、FPM 崩溃或被 OOM 杀死;排查顺序从连通性到进程池再到脚本与日志。

概念解释

502 是网关层错误,不是 PHP 业务异常页。先区分 Nginx 能否连上 FPM:连不上看地址与进程;连上了但响应非法看脚本路径与协议;进程池满则新连接排队或拒绝。FPM 错误日志、Nginx error.log、系统 OOM 记录是三类关键证据。

原理流程

  1. 检查 FPM 进程与监听地址:端口/socket 是否与 fastcgi_pass 一致。
  2. 看 Nginx error.log 报错类型:连接拒绝、超时、无效响应头还是协议错误。
  3. 查 FPM status 与错误日志:进程池是否打满、worker 是否频繁退出。
  4. 核对 SCRIPT_FILENAME 路径与部署目录一致,排除脚本找不到导致的异常响应。

代码或图示

// 文档示例:排查命令方向(在部署环境执行,本机无对应服务实例)
// 查看 FPM 监听:ss -lntp | grep 9000 或 ps -ef | grep php-fpm
// 查看进程池:FPM status 页中 active / idle / max children reached
// 查看日志:Nginx error.log、FPM www-error.log、系统 dmesg 中的 OOM 记录
// 待确认:各日志路径以实际部署配置为准

常见误区

  • 一看到 502 就改 PHP 代码:多数 502 是连通性、进程池或路径问题,与业务逻辑无关。
  • 进程池打满只加 max_children:不定位慢接口与下游阻塞,加进程只会把问题转移到数据库与内存。

追问

  • socket 文件权限错误表现为什么?答:Nginx 连接 socket 被拒绝或无权限访问,error.log 记录连接失败;需核对 socket 属主与权限。
  • FPM 被 OOM 杀死怎么判断?答:系统日志中有 OOM 记录,FPM 进程数骤降;结合内存占用与泄漏分析。

06.5.8.10-007 504 Gateway Timeout 与 502 如何区分?

一句话结论

504 是 Nginx 等待 FPM 响应超时,FPM 在线但处理过慢;502 是连不上或响应无效。504 多由慢脚本、阻塞下游、进程池排队或超时配置不当引起。

概念解释

504 发生在已建立 FastCGI 连接后,FPM 未能在 fastcgi_read_timeout 内输出响应。常见根因:PHP 等待慢数据库/外部接口、锁竞争、进程池满导致请求排队、同步重计算。客户端超时与后端实际耗时可能不一致,需同时看 Nginx、FPM 慢日志与下游指标。

原理流程

  1. 确认 Nginx error.log 为读超时而非连接拒绝。
  2. 查 FPM 慢日志与 status,定位耗时最长的脚本与下游依赖。
  3. 区分是进程排队(active 打满)还是单脚本执行慢。
  4. 优化慢下游、异步化长任务,或按业务调整超时与进程池参数。

代码或图示

// 文档示例:504 排查对照
// Nginx: upstream timed out (110: Connection timed out) while reading response header
// FPM slow log: 记录超出 slowlog 阈值的慢脚本与堆栈
// 下游指标:数据库慢查询、HTTP 外部接口耗时、Redis 命令耗时
// 待确认:slowlog 阈值与日志路径以 fpm.conf 为准

常见误区

  • 把 504 当成数据库报错:数据库只是慢脚本的可能根因之一,需要链路证据。
  • 直接调大 read_timeout 掩盖问题:超时变大只是让客户端等更久,进程池占用更久,最终仍会雪崩。

追问

  • 排队导致的 504 怎么识别?答:active 进程数长期满、请求在 FPM 队列等待;此时脚本本身不一定慢。
  • 超时后用户重复提交怎么办?答:接口做幂等与提交防重,后端长任务转异步,避免超时重试产生重复副作用。

06.5.8.10-008 静态资源为什么应由 Nginx 直接返回?

一句话结论

静态文件(图片、CSS、JS、字体)由 Nginx 直接读文件返回并设置缓存头,不进 FPM;这样避免 PHP 进程被静态请求占用,响应路径短、并发能力高。

概念解释

静态资源无业务逻辑,Nginx 内核级文件发送与缓存头部处理效率远高于 PHP 走一遍 FPM。合理配置 root/alias、过期时间、压缩与缓存命中,可降低后端压力。动态页面与静态资源在 location 层分开路由。

原理流程

  1. 按路径前缀划分静态目录,配置 root 与索引文件规则。
  2. Nginx 检查文件存在,命中则读取并返回,带 Expires/Cache-Control。
  3. 不存在的路径按前端路由规则兜底转发。
  4. 静态目录禁止解析 .php,防止上传文件被执行。

代码或图示

// 文档示例:静态资源规则
// location ^~ /static/ {
//     root /var/www/app/public;
//     expires 7d;
//     add_header Cache-Control "public, immutable";
// }
// 安全约束:静态目录内 location ~ \.php$ { deny all; }

常见误区

  • 让 PHP 输出静态文件内容:每个静态请求占用一个 FPM worker,静态流量大时迅速打满进程池。
  • 静态资源不设缓存头:浏览器重复回源,带宽与后端压力增加。

追问

  • 带版本号的静态资源怎么缓存?答:文件名含内容哈希时可设长缓存与 immutable;无哈希资源更新要缩短缓存或加版本查询串。
  • 大文件下载走哪里?答:Nginx 直接发送文件,或配合 X-Accel-Redirect 由脚本鉴权后交回 Nginx 发送。

06.5.8.10-009 文件上传在 Nginx + FPM 链路上有哪些限制?

一句话结论

上传大小受 client_max_body_size 限制,请求体先由 Nginx 缓冲到临时目录再转给 FPM;超时、临时目录空间与权限、PHP 上传配置共同决定能否上传成功,超大文件应走分片或对象存储直传。

概念解释

Nginx 层限制请求体总量,超限返回 413;FPM/PHP 层另有 upload_max_filesize、post_max_size 等限制。上传临时目录需要 Nginx 运行用户可写。单次大文件上传容易触发超时与缓冲盘占用,工程上采用分片上传、断点续传或前端直传对象存储。

原理流程

  1. 配置 Nginx 请求体上限,核对 PHP 上传与 POST 上限不低于业务需要。
  2. 确认上传临时目录存在、空间充足且权限正确。
  3. 普通小文件经 Nginx 缓冲后由 PHP 接收处理。
  4. 大文件改为分片上传:前端切片、后端合并,或直传对象存储并回调确认。

代码或图示

// 文档示例:上传相关配置方向(数值按业务文件类型确定,待确认)
// Nginx: client_max_body_size 20m; client_body_temp_path 可写目录;
// PHP:   upload_max_filesize / post_max_size / max_file_uploads
// 大文件:前端分片 → 后端校验合并;或服务端签发预签名 URL,浏览器直传对象存储

常见误区

  • 只改 Nginx 上限忘了 PHP 上限:Nginx 放过的请求在 PHP 层被拒,表现为上传数组为空。
  • 大文件整体经 PHP 接收:占用 worker 时间长、内存与临时盘压力大,超时风险高。

追问

  • 413 与上传数组为空分别看哪层?答:413 是 Nginx 请求体超限;$_FILES 为空多为 PHP post_max_size/upload_max_filesize 超限或临时目录问题。
  • 分片合并怎么做?答:前端按片上传记录序号,后端校验后按序合并;合并完成清理临时分片。

06.5.8.10-010 Nginx 限流有哪两类,配置口径是什么?

一句话结论

limit_req 按请求速率限流(漏桶模型,支持 burst 排队),limit_conn 按并发连接数限流;两者分别控制单位时间请求量与同时占用连接,可按 IP、接口或自定义键组合使用。

概念解释

limit_req_zone 定义键与速率,limit_req 在 location 生效,burst 允许短时超出排队,nodelay 表示突发不等待立即处理。limit_conn_zone 按键统计并发连接,超过限制拒绝。限流是入口保护,不能替代业务层按用户/资源的细粒度限流。

原理流程

  1. 定义限流键(如 $binary_remote_addr)与共享内存区域。
  2. 设定速率、burst 队列与是否 nodelay。
  3. 在对应 location 应用规则,超限返回指定状态码。
  4. 监控被拒数量,按压测结果调整阈值。

代码或图示

// 文档示例:Nginx 限流配置方向
// limit_req_zone $binary_remote_addr zone=perip:10m rate=10r/s;
// location /api/ {
//     limit_req zone=perip burst=20 nodelay;
//     limit_conn perip 50;
// }
// 注意:Nginx 限流按入口维度,集群下各节点独立计数;细粒度与全局限流见 Redis 限流章节

常见误区

  • 以为 Nginx 限流就是全局限流:单节点计数,多实例部署下总量等于各节点之和。
  • burst 设过大:突发请求排队等待,延迟升高,限流失去快速拒绝的意义。

追问

  • 限流返回什么状态码?答:默认 503,可配置为 429;响应体可自定义提示。
  • 登录/短信接口怎么单独限?答:按接口 location 用更严格的 zone 与键(IP + 用户名维度需在业务层实现)。

06.5.8.10-011 Nginx 层能做哪些访问控制与基础防护?

一句话结论

Nginx 可做 IP 黑白名单、基本认证、请求方法限制、静态目录保护、请求体与连接上限,以及接入 WAF 规则层;它是入口第一道防线,业务鉴权、参数校验与注入防护仍在 PHP 应用层完成。

概念解释

allow/deny 按 IP 控制访问;auth_basic 做用户名密码校验;限制只允许特定 HTTP 方法;敏感路径与静态目录做访问隔离。Web 应用层防火墙规则可在 Nginx 层或独立 WAF 服务执行,识别常见攻击特征;但应用内权限、越权与业务参数风险不能靠 Nginx 解决。

原理流程

  1. 梳理需要限制的后台、内网接口与静态目录。
  2. 配置 IP 名单、认证或方法限制。
  3. 接入规则层检查请求头、URI 与请求体特征。
  4. 应用层补齐身份认证、授权与输入校验,形成分层防护。

代码或图示

// 文档示例:访问控制规则方向
// location /admin/ {
//     allow 10.0.0.0/8;
//     deny all;
//     auth_basic "admin";
//     auth_basic_user_file /etc/nginx/.htpasswd;
// }
// 方法限制:if ($request_method !~ ^(GET|POST)$) { return 405; }

常见误区

  • 把 Nginx 当成完整 WAF:规则层只覆盖已知特征,业务越权与逻辑漏洞仍需应用层防护。
  • 后台只靠前端隐藏路径:必须在入口与应用双层做访问控制。

追问

  • 密码文件怎么生成?答:用 htpasswd 工具生成加密条目存入 auth_basic_user_file;文件权限受限。
  • 限流与访问控制冲突时谁先生效?答:按 location 内规则顺序与模块执行顺序处理,具体行为以 Nginx 版本为准,待确认。

06.5.8.10-012 FPM 进程管理模式有哪几种,参数如何配合?

一句话结论

FPM 进程管理分 static(固定进程数)、dynamic(按需增减)、ondemand(空闲不常驻,请求时拉起);核心参数为 pm.max_children、pm.start_servers、pm.min/max_spare_servers、pm.max_requests,按内存与并发量测算。

概念解释

static 恒定启动指定数量 worker;dynamic 启动时起 start_servers,按空闲区间动态伸缩;ondemand 无请求时不保留空闲进程,请求到达才 fork。max_children 是 worker 总数上限,决定并发处理能力;max_requests 控制单进程处理一定数量后重启,回收内存泄漏。进程模型细节与默认值以 FPM 版本为准,待确认。

原理流程

  1. 按单 worker 平均内存与服务器可用内存估算 max_children 上限。
  2. 按峰值并发与响应时间确定常驻进程区间。
  3. 选择管理模式:流量平稳选 static,波动大选 dynamic,低频任务可考虑 ondemand。
  4. 配置 max_requests 周期回收进程,观察 status 与内存变化调整。

代码或图示

// 文档示例:dynamic 模式参数方向(数值按内存压测确定,待确认)
// pm = dynamic
// pm.max_children = 32
// pm.start_servers = 8
// pm.min_spare_servers = 4
// pm.max_spare_servers = 12
// pm.max_requests = 500
// 估算:max_children × 单进程内存 ≤ 预留给 PHP 的内存上限

常见误区

  • max_children 按 CPU 核数拍脑袋:主要约束是内存,不是核数;进程过多导致换页与上下文切换。
  • 不设 max_requests:常驻进程累积内存泄漏,长期运行后 OOM。

追问

  • ondemand 适合什么场景?答:低频、请求量小的后台或任务机;高并发场景 fork 延迟会直接体现在首响上。
  • 进程池打满看哪个指标?答:status 页 active 达到 max_children、排队请求与 max children reached 记录。

06.5.8.10-013 一个 FPM worker 处理请求的生命周期是怎样的?

一句话结论

worker 从进程池获取 FastCGI 请求 → 初始化 PHP 请求上下文 → 执行入口脚本与框架引导 → 输出响应 → 回收请求内变量与连接 → 回到空闲状态等待下一个请求。

概念解释

FPM worker 常驻复用,每个请求独立初始化与释放作用域;请求结束后请求级变量销毁,但进程内静态缓存、全局对象与持久连接可能保留。理解生命周期有助于判断内存泄漏位置:是请求内未释放,还是进程级缓存持续增长。OPcache 等运行时缓存跨请求保留,属于运行时优化而非请求内数据。

原理流程

  1. 监听 socket 上的新请求,worker 被调度处理。
  2. 解析 FastCGI 参数,初始化 $_SERVER/$_GET/$_POST 等超全局。
  3. 执行脚本,框架完成路由、业务与响应输出。
  4. 请求结束清理请求资源;进程按 max_requests 或内存水位决定是否重启。

代码或图示

// 文档示例:请求内资源释放关注点
// - 请求级:局部变量、临时对象、查询结果,请求结束自动销毁
// - 进程级:static 变量、单例、持久连接,跨请求保留,需评估增长
// - 每个请求结束后检查:是否有静态数组只增不减、连接未关闭
// 本机为 CLI 环境,FPM 生命周期行为以实际 FPM 进程实测为准

常见误区

  • 以为请求结束进程内所有数据都清空:进程级静态状态跨请求保留,可能累积脏数据。
  • 在请求间用 static 保存业务上下文:多请求复用导致串数据,应放入请求上下文或缓存服务。

追问

  • 持久连接在 worker 复用时怎么处理?答:连接随进程保留,需设置空闲超时与断开重连;避免空闲连接堆积。
  • 框架引导开销如何跨请求摊薄?答:依赖 OPcache 与框架编译缓存;请求内仍需完成路由与容器初始化。

06.5.8.10-014 FPM status 页暴露哪些关键指标?

一句话结论

status 页提供进程池汇总:已监听队列、活跃/空闲进程数、达到最大子进程次数、请求数与慢日志计数;用于判断进程池是否打满、伸缩是否合理与慢请求规模。

概念解释

启用 FPM status 路由后,可按 HTML 或 JSON/纯文本查看池状态。核心字段包括 accepted conn、listen queue、active processes、idle processes、max children reached、slow log 计数。指标要结合 Nginx 与下游指标一起看,单看进程数无法定位根因。具体字段名与默认开关以版本为准,待确认。

原理流程

  1. 在 FPM 配置启用 status 路径,并在 Nginx 暴露或内网访问该路径。
  2. 采集活跃/空闲进程、监听队列与 max children reached 计数。
  3. 持续记录请求量与慢日志计数,观察伸缩趋势。
  4. 按积压与内存数据调整进程数与管理模式。

代码或图示

// 文档示例:status 配置与采集方向
// fpm.conf: pm.status_path = /fpm-status
// nginx: location = /fpm-status { allow 内网; deny all; fastcgi_pass fpm:9000; }
// 采集字段:active processes / idle processes / listen queue /
//           max children reached / slow requests
// 待确认:字段名称与输出格式以 FPM 版本为准

常见误区

  • 把 status 暴露到公网:泄露进程池与路径信息,应限制内网或认证访问。
  • 只看活跃进程数:配合空闲进程、队列与慢请求计数才能判断健康度。

追问

  • listen queue 持续增长说明什么?答:进程池处理不过来,请求在队列等待;需扩容或优化处理速度。
  • max children reached 累计增加说明什么?答:多次打满进程池,当前上限或处理能力不足。

06.5.8.10-015 FPM 慢日志与 PHP 慢执行如何配合排查?

一句话结论

FPM 慢日志记录执行超过 request_slowlog_timeout 的 worker 堆栈,PHP 错误日志记录脚本异常与告警;两者配合定位慢脚本位置,再下钻到具体下游依赖。

概念解释

慢日志在脚本执行超阈值时转储当前调用栈,能指出卡在哪段代码;PHP 错误日志记录警告、致命错误与未捕获异常。慢不等于报错:慢可能是等待数据库、外部接口、锁或 IO。排查时先从慢日志堆栈定位代码段,再看下游耗时指标。日志路径与阈值配置在 fpm.conf 与 php.ini 中,待确认。

原理流程

  1. 设置慢日志阈值,收集超阈值请求的调用栈。
  2. 按脚本路径与堆栈热点聚合慢请求分布。
  3. 对照 PHP 错误日志与下游指标,区分代码慢、等待慢还是资源竞争。
  4. 优化后复测慢日志计数与接口耗时。

代码或图示

// 文档示例:慢日志配置方向(阈值按接口耗时分布设定,待确认)
// fpm.conf: request_slowlog_timeout = 10s
// fpm.conf: slowlog = /var/log/php-fpm/slow.log
// php.ini:  error_log = /var/log/php/error.log
// 慢日志堆栈示例(文档描述):调用帧指向控制器 → 服务 → 下游调用

常见误区

  • 慢日志阈值设得过小:正常慢接口也被记录,噪音淹没真正问题。
  • 只看耗时不看堆栈:无法判断慢点在业务代码还是下游等待。

追问

  • 慢日志能记录正在执行的 SQL 吗?答:它记录 PHP 调用栈,SQL 文本需结合数据库慢查询日志与请求 trace 关联。
  • 进程被 request_terminate_timeout 终止记在哪里?答:FPM 错误日志与系统记录,区别于慢日志的堆栈转储。

06.5.8.10-016 为什么 PHP 用 FastCGI 转发而不是 proxy_pass 反向代理?

一句话结论

PHP-FPM 只监听 FastCGI 协议,不提供 HTTP 服务,因此 Nginx 用 fastcgi_pass 转发;proxy_pass 用于把 HTTP 请求转发给另一个 HTTP 后端服务,两者协议与参数体系不同。

概念解释

FastCGI 是常驻进程与 Web 服务器之间的协议,参数以环境变量形式传递脚本路径与请求元数据;HTTP 反向代理转发完整 HTTP 请求与响应头。架构中若 PHP 业务包了一层 HTTP 服务(如常驻 Web 框架),才用 proxy_pass;传统 FPM 部署必须走 FastCGI。混用两种转发方式会出现协议错误。

原理流程

  1. 判断后端暴露的协议:FPM 是 FastCGI,HTTP 服务是 HTTP。
  2. FastCGI 转发配置 fastcgi_pass 与 fastcgi 参数。
  3. HTTP 转发配置 proxy_pass 与 proxy 头(Host、X-Forwarded-*)。
  4. 跨服务部署时核对监听协议与端口,避免协议错配。

代码或图示

// 文档示例:两种转发对比
// FastCGI(php-fpm):
//   fastcgi_pass fpm:9000;
//   fastcgi_param SCRIPT_FILENAME ...;
// HTTP 后端(其他 Web 服务):
//   proxy_pass http://backend:8080;
//   proxy_set_header Host $host;
//   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

常见误区

  • 对 FPM 地址用 proxy_pass:协议不匹配,返回无效响应或 502。
  • 对 HTTP 后端用 fastcgi_pass:参数体系不兼容,后端无法解析请求。

追问

  • X-Forwarded-* 头在哪一层设置?答:HTTP 反向代理层设置;FastCGI 场景通过 fastcgi_param 传递客户端信息。
  • 后端获取真实 IP 怎么配?答:代理层传递头,应用层按可信代理链解析。

06.5.8.10-017 Nginx 如何设置静态资源与响应的缓存头?

一句话结论

静态资源用 expires 与 Cache-Control 控制浏览器与中间缓存有效期,配合 ETag/Last-Modified 做条件请求;动态接口按不缓存或短缓存策略单独设置。

概念解释

expires 生成 Expires 与 Cache-Control: max-age;带内容哈希的静态资源可长缓存并标记 immutable;未哈希资源更新频繁,缓存期要短。条件请求由 Nginx 校验文件时间戳或生成 ETag,未修改返回 304。动态响应默认不缓存,鉴权与个性化数据禁止公开缓存。

原理流程

  1. 区分静态资源与动态接口,分别定义缓存策略。
  2. 静态目录配置过期时间与缓存头,开启条件请求校验。
  3. 动态接口按语义设置 Cache-Control: no-store 或私有短缓存。
  4. 上线发版后核对静态资源 URL 版本变化,避免旧缓存残留。

代码或图示

// 文档示例:缓存头方向
// location ~* \.(css|js|png|jpg|svg|woff2)$ {
//     expires 30d;
//     add_header Cache-Control "public";
// }
// 动态接口:add_header Cache-Control "no-store, private";
// 条件请求:Nginx 按文件 mtime 处理 If-Modified-Since;ETag 行为以版本为准

常见误区

  • 对带用户数据的接口设公开长缓存:多用户共享缓存导致串数据。
  • 无哈希静态资源设超长缓存:发版后用户拿到旧文件。

追问

  • immutable 是什么含义?答:告知浏览器资源在缓存期内不会变更,无需条件校验;只适用于内容哈希文件名资源。
  • 304 怎么产生?答:客户端带条件请求头,Nginx 校验资源未变后返回 304 与空响应体。

06.5.8.10-018 Nginx 在 HTTPS 与压缩上承担什么职责?

一句话结论

Nginx 通常作为 TLS 终止层处理证书、握手与 HTTPS 配置,并承担 gzip/Brotli 等响应压缩;后端 FPM 只处理业务内容,不直接面对浏览器 TLS。

概念解释

证书部署在入口 Nginx,浏览器到 Nginx 加密传输,Nginx 到内网后端可按网络环境走明文或内部加密。压缩在出口层对文本类响应统一处理,减少后端重复压缩逻辑。HTTP 到 HTTPS 的跳转、HSTS 头等策略也在入口配置。证书有效期与续期需纳入运维检查。

原理流程

  1. 证书与私钥配置在 Nginx 站点,监听 443 并配置协议套件。
  2. 浏览器完成 TLS 握手,明文或内网加密转发后端。
  3. 响应在出口按 MIME 类型压缩后返回。
  4. 定期检查证书有效期与加密配置基线。

代码或图示

// 文档示例:HTTPS 与压缩职责划分(具体套件与压缩级别待确认)
// 入口 Nginx:listen 443 ssl; ssl_certificate / ssl_certificate_key; gzip on;
// 内网 FPM:只监听内网地址,不直接暴露公网
// 后端应用:不感知 TLS,按内部协议处理请求

常见误区

  • 证书私钥随代码入库:私钥应走部署机密管理,仓库中不保存。
  • 对内网后端也强制假设链路已安全:内网隔离与加密策略需按安全规范评估。

追问

  • 压缩对图片等二进制有必要吗?答:已压缩格式收益小,应按 MIME 类型选择是否压缩。
  • TLS 终止后后端怎么拿到协议信息?答:通过转发头与参数传递原始协议、主机与客户端信息。

06.5.8.10-019 线上 502/504 的标准排查顺序是什么?

一句话结论

先看 Nginx error.log 区分错误类型与超时阶段,再查 FPM status 与错误日志判断进程池状态,接着定位慢脚本与下游依赖,最后核对配置路径、权限与资源水位,形成从入口到后端的闭环。

概念解释

排查顺序遵循链路从上到下:入口连通性 → 进程池负载 → 脚本执行 → 下游依赖。每一步都要有日志或指标证据,不凭猜测改配置。复现问题时记录请求时间、trace_id 与接口路径,便于跨日志关联。

原理流程

  1. 收集报错时间、接口、状态码与 Nginx error.log 条目。
  2. 检查 FPM 进程是否存活、监听地址是否正确、status 是否打满。
  3. 查 FPM 慢日志与 PHP 错误日志,定位脚本与异常。
  4. 下钻数据库、Redis、外部接口耗时;核对内存、磁盘与连接资源。
  5. 修复后复测错误率与慢请求计数。

代码或图示

// 文档示例:排查记录模板
// 时间 / 接口 / 状态码 / Nginx 报错摘要
// FPM: active=? idle=? listen_queue=? max_children_reached=?
// 慢日志: 脚本与调用栈
// 下游: DB 耗时 / 外部接口耗时 / Redis 命令耗时
// 结论: 根因层级(连通性/进程池/脚本/下游/资源)与处理动作

常见误区

  • 跳过日志直接重启服务:现象恢复但根因未明,问题反复出现。
  • 只看应用报错日志:502/504 往往在应用日志之前就已发生,必须先看入口与 FPM 日志。

追问

  • 间歇性 502 怎么抓证据?答:先加错误率监控与采样日志,复现时保留 Nginx/FPM/系统三类日志片段。
  • 修复后如何验证?答:观察错误率、进程池水位与慢请求计数回落,对比修复前后指标。

06.5.8.10-020 Nginx + FPM 部署配置有哪些易踩的坑?

一句话结论

常见坑包括脚本路径拼接错误、静态目录可解析 PHP、socket 权限不当、超时与缓冲配置失衡、上传临时目录不可写、真实 IP 未透传、配置改动未校验即 reload。

概念解释

配置类问题多为路径、权限与规则遗漏。上线前应做配置语法校验,逐环境核对文档根目录、监听地址、目录权限与上传限制。站点配置与部署目录保持一致,避免多环境复制粘贴导致路径漂移。

原理流程

  1. 部署前核对 root、SCRIPT_FILENAME、FPM 监听与 socket 路径。
  2. 检查静态目录 PHP 解析关闭、上传临时目录可写、运行用户一致。
  3. 校验配置语法,再 reload;先灰度观察错误日志与 status。
  4. 整理配置清单纳入交付检查项,避免环境间漂移。

代码或图示

// 文档示例:上线前核对清单
// [ ] root / SCRIPT_FILENAME 与部署目录一致
// [ ] fastcgi_pass 地址(TCP/socket)与 FPM 监听一致
// [ ] 静态目录禁止解析 .php
// [ ] 上传临时目录存在且可写,大小限制两层一致
// [ ] 超时、缓冲、进程池参数按压测值配置
// [ ] nginx -t 语法通过后再 reload

常见误区

  • 改完配置直接 reload 生产:语法错误会导致 reload 失败或站点异常,应先校验。
  • 开发环境配置复制到生产:路径、域名、上传上限与证书差异未核对。

追问

  • 配置校验命令是什么?答:Nginx 提供测试配置命令,具体调用方式以部署环境 Nginx 版本为准;通过后再执行 reload。
  • 多站点共用 FPM 要注意什么?答:各站点脚本路径隔离,进程池与用户按部署规范划分,避免跨站点文件访问。