Nginx 与 PHP-FPM 高效协同的实用指南
一 架构与通信机制
- 采用Nginx + PHP-FPM的分离式架构：Nginx负责静态资源、反向代理与连接管理，PHP-FPM维护进程池执行PHP脚本，二者通过FastCGI协议协作，具备解耦、稳定与高性能的优势。
- 通信方式优先选择Unix Domain Socket（如：unix:/var/run/php/php8.1-fpm.sock），同机通信性能通常优于TCP Socket（如：127.0.0.1:9000）。
- 基本流程：Nginx匹配到**.php请求后，设置必要的FastCGI参数（核心是SCRIPT_FILENAME**），将请求转发至PHP-FPM；PHP-FPM执行后把结果返回Nginx，再由Nginx回写给客户端。
二 快速搭建与最小可用配置
- 安装组件（示例）
- Ubuntu/Debian：sudo apt update && sudo apt install nginx php-fpm
- CentOS/RHEL：sudo yum install epel-release && sudo yum install nginx php-fpm
- 配置 PHP-FPM（池配置，常见路径如：/etc/php-fpm.d/www.conf）
- 监听示例：listen = /run/php-fpm/www.sock（或 127.0.0.1:9000）
- 配置 Nginx（server 块关键片段）
- 基本转发：
location ~ .php$ {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/run/php-fpm/www.sock;
}
- 若使用发行版提供的快捷片段（Debian 常见：include snippets/fastcgi-php.conf;），仍需确保 SCRIPT_FILENAME 正确。
- 启动与验证
- 启动：sudo systemctl start nginx && sudo systemctl start php-fpm
- 开机自启：sudo systemctl enable nginx && sudo systemctl enable php-fpm
- 验证：在站点根目录创建 info.php（），访问应看到PHP信息页（测试后删除该文件）。
三 性能与稳定性优化
- Nginx 层
- 并发能力：理论最大并发 = worker_processes × worker_connections；通常将 worker_processes 设为CPU核心数，worker_connections 依据内存与文件描述符上限调整。
- 长连接：启用 keepalive 减少握手开销（如 keepalive_timeout 30–65s；keepalive_requests 控制单连接请求数）。
- 压缩与缓存：启用 gzip（如 gzip_comp_level 5；压缩 text/css、application/javascript 等）；对静态资源设置长期缓存（如 expires 1y; Cache-Control public）。
- PHP-FPM 层
- 进程模型：
- static：固定进程数，适合稳定高并发；
- dynamic：按需伸缩，适合流量波动；
- ondemand：极省内存，适合低并发/内存紧张，高峰可能慢启动导致超时。
- 关键参数：合理设置 pm.max_children、start_servers / min_spare_servers / max_spare_servers；通过 pm.max_requests 定期回收可能泄漏的进程；开启慢日志定位耗时操作。
- 协同优化
- 本地优先用 Unix Socket，并确保 Nginx 与 PHP-FPM 对 socket 文件的读写权限一致。
- 对纯动态接口可启用 FastCGI 缓存（如定义缓存区、缓存键与有效时间），显著降低 PHP-FPM 负载。
- 耗时任务（邮件、图片处理等）建议异步化/队列化，缩短请求响应时间、提升稳定性。
四 超时与常见错误定位
- 超时体系与典型报错
- php.ini：max_execution_time（脚本最大执行时间，不含部分流/DB耗时）
- PHP-FPM：request_terminate_timeout（请求终止上限，通常略大于 max_execution_time）
- Nginx FastCGI：fastcgi_connect/read/send_timeout
- 现象区分：PHP-FPM 超时常见 502 Bad Gateway；Nginx 侧超时常见 504 Gateway Time-out。
- 快速排查路径
- 核对 Nginx 与 PHP-FPM 的监听地址/端口或 socket 路径一致；检查权限与服务状态。
- 查看 Nginx error.log 与 PHP-FPM error.log / www-error.log 的错误细节。
- 使用配置语法检查：sudo nginx -t；逐步回滚近期改动定位问题。
- 访问异常页（如 info.php）验证连通性，确认后再移除敏感文件。
五 监控与持续调优
- 暴露与观测
- Nginx：启用 stub_status 查看连接数、请求率等；
- PHP-FPM：启用 pm.status_path 观察进程池使用、排队与慢请求；
- 系统与应用：结合 htop/nmon 与 APM（如 New Relic、XHProf）定位瓶颈。
- 调优闭环
- 基准测试（如 ab/wrk）→ 依据 QPS/响应时间/资源占用 调整 worker_connections、pm.max_children、缓存策略 → 复测验证 → 持续复盘与 A/B 测试。