如何配置 server 块兼容后端多个不同的 PHP-FPM 监听池-Nginx-PHP中文网

nginx单个server块对接多个php-fpm池的核心是按请求特征（路径、域名等）分发，而非动态切换；可通过嵌套location或map指令实现精准路由，需确保各池监听地址互斥且script_filename正确。

如何配置 server 块兼容后端多个不同的 php-fpm 监听池

要让 Nginx 的一个 server 块 对接多个不同的 PHP-FPM 监听池，核心不是“动态切换”，而是按请求特征（如路径、域名、文件类型）分发到不同池。Nginx 本身不支持单个 location 内自动轮询或条件选择多个 fastcgi_pass，但可通过嵌套 location 或 map + variables 实现精准路由。

按 URL 路径分发到不同 PHP-FPM 池

适合同一域名下不同子目录使用不同 PHP 版本或配置的场景（例如 /php74/ 走 PHP 7.4，/php82/ 走 PHP 8.2）：

在 server 块内定义多个 location，每个匹配特定前缀，各自指向独立的 fastcgi_pass
确保各 PHP-FPM 池已启动且监听地址互不冲突（如 127.0.0.1:9074、127.0.0.1:9082 或不同 socket 文件）
SCRIPT_FILENAME 必须用 $document_root$fastcgi_script_name，且 $document_root 在当前 location 上下文中有效（推荐把 root 放在 server 级，或在每个 location 中显式定义）

示例：

server {
  listen 80;
  server_name example.test;
  root /var/www/html;
  index index.php;

  location /php74/ {
    alias /var/www/php74/;
    location ~ \.php$ {
      include fastcgi_params;
      fastcgi_pass 127.0.0.1:9074;
      fastcgi_param SCRIPT_FILENAME $request_filename;
    }
  }

  location /php82/ {
    alias /var/www/php82/;
    location ~ \.php$ {
      include fastcgi_params;
      fastcgi_pass unix:/run/php/php8.2-fpm.sock;
      fastcgi_param SCRIPT_FILENAME $request_filename;
    }
  }
}

用 map 指令动态设置 fastcgi_pass

适合根据请求头、参数或 URI 规则做轻量级分流（如 ?engine=82 强制走 PHP 8.2），需配合变量使用：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 http 块顶部定义 map，将条件映射为后端地址变量（如 $php_backend）
在 server 的 location ~ \.php$ 中，用 fastcgi_pass $php_backend 替代固定值
注意：map 只能用于简单判断，不支持正则捕获或复杂逻辑；所有 fastcgi_param 仍需完整保留

示例：

http {
  map $arg_engine $php_backend {
    default "127.0.0.1:9000";
    82 "unix:/run/php/php8.2-fpm.sock";
    74 "127.0.0.1:9074";
  }

  server {
    listen 80;
    server_name example.test;
    root /var/www;
    location ~ \.php$ {
      include fastcgi_params;
      fastcgi_pass $php_backend;
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
  }
}

安全与调试关键点

无论哪种方式，以下三点必须核对：

PHP-FPM 池 listen 地址必须可访问：TCP 端口未被占用、socket 文件权限允许 Nginx worker 用户（如 www-data）读写
每个 fastcgi_pass 后端对应的 pool 需启用对应扩展、open_basedir 若设了，要包含目标项目路径
用 curl -I http://example.test/path/test.php 和 nginx error_log 查看是否出现 “No input file specified” 或 “Connection refused”，快速定位 SCRIPT_FILENAME 错误或后端未响应