phpEnv中Nginx负载均衡需手动编辑其conf/nginx.conf或vhost/*.conf文件，在http块内定义upstream并确保被server引用，修改后须重载Nginx而非仅重启，且proxy_pass须正确结尾以保留路径。
phpEnv 是 Windows 下的集成环境套件，自带 Nginx，但它的默认配置不包含 upstream 块，也不能直接在面板里点选“负载均衡策略”。想用它跑负载均衡，本质是手动改 Nginx 配置文件——不是调 phpEnv 界面，而是绕过它直接操作 Nginx。
phpEnv 的 Nginx 配置文件在哪？
phpEnv 把 Nginx 配置放在安装目录下的 Nginx/conf/nginx.conf（或有时是 Nginx/conf/vhost/*.conf）。必须确认你编辑的是真正被加载的配置：启动 phpEnv 后，点“Nginx” → “配置文件”，它会打开实际生效的那个文件。别改错位置，否则 nginx -t 检查通过也无效。
常见错误现象：nginx -t 显示 success，但请求始终只打到一台后端，说明 upstream 没被当前 server 块引用，或者配置没 reload。
- 确保
upstream块写在http { }大括号内，不能塞进server或location - phpEnv 默认可能把虚拟主机配置拆到
vhost/目录，此时需在对应.conf文件顶部或http块里定义upstream - 改完必须点 phpEnv 面板里的 “重载 Nginx” 或执行
nginx -s reload，仅重启服务不够
weight 参数怎么设才生效？
权重只在轮询（round robin）模式下起作用，且是相对比例。比如 server 127.0.0.1:8081 weight=3; 和 server 127.0.0.1:8082 weight=1;，理论请求分发比是 3:1 —— 但前提是两台后端都健康、响应及时。一旦某台超时或返回 502，Nginx 会按 max_fails/fail_timeout 临时摘除它，权重比就失效了。
立即学习“PHP免费学习笔记（深入）”；
容易踩的坑：
-
weight不能写在ip_hash或least_conn块里（Nginx 会报错） - phpEnv 自带的 Nginx 版本通常是开源稳定版，不支持
hash $request_uri consistent;这类高级哈希，别硬套第三方文档 - 本地测试时用
127.0.0.1:port没问题，但若后端是 WAMP/XAMPP 启动的 Apache，要确认其监听的是0.0.0.0:8080而非127.0.0.1:8080，否则 Nginx 从外部访问不到
proxy_pass 怎么写才不丢路径？
这是 phpEnv 用户最常翻车的地方：proxy_pass http://my_upstream; 和 proxy_pass http://my_upstream/; 行为完全不同。前者保留原始 URI（如 /api/user），后者会把 location 匹配前缀砍掉再拼接（变成 /user）。
正确写法取决于你的后端路由是否依赖完整路径：
- 如果后端是 Laravel/Symfony 等框架，通常要保留路径 → 用
proxy_pass http://my_upstream;（结尾无斜杠） - 如果后端是静态文件服务或简单 HTTP API，且 location 已精确匹配 → 可用
proxy_pass http://my_upstream/;（结尾有斜杠） - 绝对不要写
proxy_pass http://my_upstream:8080;或proxy_pass http://127.0.0.1:8080;，这会让 Nginx 当作普通反代，跳过 upstream 负载逻辑
为什么健康检查总不生效？
phpEnv 自带的 Nginx 是开源版，没有主动健康检查（active check）。所谓“自动剔除”只是被动行为：某台后端连续失败 max_fails 次后标记为 down，等 fail_timeout 时间过后再试一次。这意味着：后端进程卡死但端口仍通，Nginx 会继续转发请求，直到第一个超时发生。
缓解方案只有两个：
- 调严
proxy_connect_timeout和proxy_read_timeout（例如都设成 3s），让失败更快暴露 - 在
upstream中为每台 server 显式加max_fails=1 fail_timeout=5s，避免默认 10s 等待太长
别指望 phpEnv 面板里能开 nginx-plus 功能，它压根没集成。
