phpEnv本身不提供灰度能力，需手动配置Nginx：在http块用map基于$http_cookie正则匹配gray=1等规则映射后端，配合upstream指向不同端口服务，并确保新版本进程已启动且可访问。
phpEnv 本身不提供灰度发布能力，它只是本地 PHP 环境集成包（含 Nginx、PHP、MySQL），真正实现灰度发布的，是你手动配置的 nginx.conf 或站点配置文件。关键不是「phpEnv 能不能」，而是「你有没有在它的 Nginx 里配对 upstream + 条件路由」。
如何用 phpEnv 的 Nginx 做基于 Cookie 的灰度测试
phpEnv 默认把 Nginx 配置放在 phpEnv\nginx\conf\nginx.conf 或 phpEnv\nginx\vhost*.conf 下。你需要直接改这些文件，而不是依赖图形界面。
- 灰度目标：让携带
Cookie: gray=1的请求走新版本（比如本地跑在127.0.0.1:8081的 Laravel dev 分支），其余走旧版（127.0.0.1:8080） - 必须把
map写在http块顶层，不能塞进server或location里 -
proxy_pass <a href="https://www.php.cn/link/7c677ff4c58e458338c5f7e74556735d">https://www.php.cn/link/7c677ff4c58e458338c5f7e74556735d</a>中的变量拼接，要求 Nginx 版本 ≥ 1.3.10 ——phpEnv通常自带 1.20+，基本满足
http {
# 提取 Cookie 并映射后端组
map $cookie_gray $backend {
"1" "backend_gray";
default "backend_old";
}
<pre class='brush:php;toolbar:false;'>upstream backend_old {
server 127.0.0.1:8080;
}
upstream backend_gray {
server 127.0.0.1:8081;
}
server {
listen 80;
server_name localhost;
location / {
proxy_pass https://www.php.cn/link/7c677ff4c58e458338c5f7e74556735d;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}}
重启 phpEnv 的 Nginx（或点面板上的「重启 Nginx」按钮）后，用 curl 测试：
立即学习“PHP免费学习笔记（深入）”；
curl -H "Cookie: gray=1" http://localhost/api/user应返回新版本响应；不带该 Cookie 则走老版本。
为什么用 $http<em>cookie</em> 而不是 $cookie* 更稳妥
$cookie_gray 只能精确匹配名为 gray 的 Cookie，且值必须完全一致（空格、分号都会截断）。但实际开发中，前端可能发来：
-
gray=1; path=/→$cookie_gray是"1"✅ -
uid=abc; gray=1; token=xyz→$cookie_gray仍是"1"✅ -
GRAY=1或Gray=1→$cookie_GRAY才能取到 ❌
而 $http_cookie 是原始请求头全文，配合正则更灵活：
map $http_cookie $backend {
~*gray=1 "backend_gray";
~*is_gray=true "backend_gray";
default "backend_old";
}这样即使 Cookie 名大小写不统一、或有多个键，也能兜住。但注意：map 中正则匹配是全局扫描，别写 ~*gray 这种太宽泛的，容易误匹配（比如 graylog_token）。
基于 IP 的本地灰度最容易踩的坑
你在公司内网用 192.168.x.x 测试，想让自己的电脑（192.168.1.100）走灰度，同事的（192.168.1.101）走旧版。看起来简单，但：
-
$remote_addr在 phpEnv 本地环境里，永远是 127.0.0.1（因为浏览器和 Nginx 同机，没经过代理） - 即使你配了
if ($remote_addr = 127.0.0.1) { ... }，所有请求都命中，失去分流意义 - 真正可行的是：用不同 host 区分，比如
gray.localhost和old.localhost，然后在 hosts 文件里都指向 127.0.0.1，再用server_name匹配
或者退一步，用 URL 参数（?env=gray）替代 IP 判断，本地调试更可控。
phpEnv 的局限性在于它不帮你管理多套后端进程——你得自己启动两个 PHP-FPM 实例或两个 Laravel serve，分别监听不同端口；Nginx 只负责路由。很多人卡在这步，以为配完 Nginx 就能灰度，结果新版本服务根本没起来，proxy_pass 直接 502。动手前先确认 127.0.0.1:8081 确实能 curl 通，比调 Nginx 配置重要得多。
