Nginx 中 PHP-FPM 如何实现多套环境配置的动态切换

Nginx 通过解耦 PHP-FPM 实现多版本环境动态切换：按域名/路径绑定独立 FPM 实例、用 map 模块运行时路由、upstream 实现负载与热切换、结合 CI/CD 注入环境标识。

Nginx 本身不直接管理 PHP 版本或环境，但通过与 PHP-FPM 的解耦设计，可以灵活实现多套 PHP 环境（如不同版本、不同配置、不同项目隔离）的动态切换。核心在于：Nginx 负责路由分发，PHP-FPM 负责执行；切换本质是让不同请求走不同的 PHP-FPM 实例。

按域名或路径绑定独立 PHP-FPM 实例

这是最常用、最清晰的方式。每个站点（或子路径）对应一个专属的 PHP-FPM pool，监听不同端口或 Unix Socket：

1. 为 Laravel 项目配置 php8.2-fpm 监听 /run/php/laravel.sock，Nginx 中写：

   fastcgi_pass unix:/run/php/laravel.sock;

2. 为旧 WordPress 项目配置 php7.4-fpm 监听 /run/php/wordpress.sock，Nginx 中写：

   fastcgi_pass unix:/run/php/wordpress.sock;

3. 同一台服务器可并存多个 php-fpm 服务（如 php8.1-fpm、php8.3-fpm），只需确保各自 www.conf 中的 listen 和 pm.* 参数互不冲突

用变量 + map 模块实现运行时路由选择

适合需要根据请求头、参数或 Cookie 动态决定 PHP 环境的场景（例如灰度发布、A/B 测试）：

1. 在 http 块中定义映射关系：

   map $http_x_php_version $upstream_php {

   default unix:/run/php/php8.2-fpm.sock;

   "8.1" unix:/run/php/php8.1-fpm.sock;

   "7.4" unix:/run/php/php7.4-fpm.sock;

   }

2. 在 location ~ .php$ 中使用：

   fastcgi_pass $upstream_php;

3. 客户端发起请求时带上 X-PHP-Version: 8.1，即可命中对应 FPM 实例

通过 upstream 配置实现负载与切换分离

把 PHP-FPM 当作后端服务来管理，便于统一控制、健康检查和热切换：

1. 定义 upstream 组：

   upstream php_backend {

   server unix:/run/php/php8.2-fpm.sock max_fails=3 fail_timeout=30s;

   server unix:/run/php/php8.3-fpm.sock backup;

   }

2. 在 location 中调用：

   fastcgi_pass php_backend;

3. 主实例异常时自动切到 backup，也可手动注释某行实现人工切换
4. 配合 reload 操作（nginx -s reload）可秒级生效，无需重启整个 Nginx

配合脚本与部署工具完成环境标识注入

真实生产中，常结合 CI/CD 或容器化流程，在部署时自动注入环境上下文：

1. Docker Compose 中为不同服务分配不同 PHP_VERSION 环境变量，启动对应镜像的 PHP-FPM 容器
2. Ansible Playbook 根据 inventory 分组，生成带版本标识的 Nginx server 块和对应的 php-fpm pool 配置
3. 在 PHP 应用入口（如 index.php）中读取 $_SERVER['PHP_FPM_LISTEN'] 或自定义 header，用于日志打标或功能开关