phpEnv配置Nginx根据Cookie分流 phpEnv A/B测试配置-php教程-PHP中文网

Nginx可通过map指令根据Cookie值动态选择PHP-FPM上游，实现按版本分流；phpenv仅负责多版本PHP-FPM实例的安装与管理，不参与Nginx路由逻辑，二者职责分离，协作链路为：请求→Nginx读Cookie→map映射→upstream→对应PHP-FPM socket。

phpenv配置nginx根据cookie分流 phpenv a/b测试配置

phpenv 和 Nginx 根据 Cookie 分流是两件完全独立的事：前者管 PHP 运行时版本切换，后者管 HTTP 请求路由。phpenv 不参与、也不影响 Nginx 的 Cookie 分流逻辑——它只在 CLI 或 FPM 子进程启动时决定用哪个 php-fpm 二进制，而 Nginx 的 proxy_pass 或 fastcgi_pass 是在请求进入后由配置驱动的。

如果你看到“phpEnv 配置 Nginx 分流”这类说法，大概率是混淆了执行层：Nginx 做分流，PHP（无论哪个版本）只是被代理过去的服务端之一；phpenv 只负责让你本地能同时装 php-7.4 和 php-8.3，并让 php-fpm-74.sock 和 php-fpm-83.sock 同时跑起来——但怎么把请求打到哪个 socket，全靠 Nginx 配置。

所以真实协作链路是：用户请求 → Nginx（读 $cookie_ab_version → map → 选 upstream）→ fastcgi_pass unix:/var/run/php/php7.4-fpm.sock 或 fastcgi_pass unix:/var/run/php/php8.3-fpm.sock

如何让不同 PHP 版本服务对应不同 Cookie 分流组

先用 phpenv 安装并启动多个 PHP-FPM 实例
每个版本监听独立 Unix socket（推荐）或端口，例如：
php-7.4 → /var/run/php/php7.4-fpm.sock
php-8.3 → /var/run/php/php8.3-fpm.sock
启动命令需明确指定配置文件：php-fpm7.4 -y /etc/php/7.4/fpm/php-fpm.conf
在 Nginx http 块中用 map 映射 Cookie 到 upstream 名称
map 必须定义在 http 块顶层，不能放在 server 或 location 里：

Nginx Hosting
通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载
```
map $cookie_ab_version $php_upstream {
  "v74" "php74_backend";
  "v83" "php83_backend";
  default "php74_backend";
}
```

定义两个 upstream，分别指向不同 PHP-FPM socket

upstream php74_backend {
  server unix:/var/run/php/php7.4-fpm.sock;
}
upstream php83_backend {
  server unix:/var/run/php/php8.3-fpm.sock;
}

在 location ~ .php$ 中使用变量代理

location ~ \.php$ {
  fastcgi_pass $php_upstream;
  include fastcgi_params;
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

为什么不能在 location 里用 if + set 做 PHP 版本切换

if 在 location 中对 fastcgi_pass 变量赋值不生效：Nginx 的 fastcgi_pass 不支持运行时变量解析（仅 proxy_pass 支持），硬写 fastcgi_pass $backend 会报错 "fastcgi_pass" directive is not allowed here
即使绕过（比如用 rewrite + 内部重定向），也会破坏 FastCGI 协议头传递，导致 SCRIPT_NAME 错乱、PATH_INFO 丢失
map 是唯一安全、原生、声明式支持动态 fastcgi_pass 目标的方案（通过间接绑定 upstream）

常见踩坑点

$cookie_ab_version 是大小写敏感的：前端设 Ab_Version=v74，Nginx 读不到，必须用 $cookie_Ab_Version 或统一约定小写
PHP-FPM socket 文件权限必须让 Nginx worker 进程（通常是 www-data 或 nginx 用户）可读可写，否则 502
map 匹配顺序重要：正则 ~*v8 放在 "v83" 前面，会导致 v83 永远不命中
phpenv 管理的 FPM 实例默认不自动开机自启，需手动写 systemd service 或 supervisord 配置，否则重启后分流失效