phpEnv Nginx负载均衡本地模拟配置教程-php教程-PHP中文网

nginx负载均衡核心是upstream模块，必须定义在http块顶层，配合fastcgi_pass指向多php-fpm端口（如9000/9001/9002），禁用proxy_pass；需手动启动多个php-fpm实例并验证响应头x-php-port变化以确认分发生效。

phpenv nginx负载均衡本地模拟配置教程

本地用 phpEnv 搭建 Nginx 负载均衡，核心不是“能不能”，而是“怎么绕过限制”——phpEnv 默认只开一个 Nginx 实例、一个 PHP-FPM 进程，不支持多后端节点。真要模拟，得手动启多个 PHP 服务端口 + 改写 Nginx 配置，否则 upstream 会直接报 invalid host in upstream。

phpEnv 下启动多个 PHP-FPM 实例（非默认方式）

phpEnv 自带的「PHP 启动」按钮只拉起一套 php-fpm，监听默认端口（如 9000）。要模拟负载均衡，必须额外启动至少两个独立 PHP-FPM 进程，监听不同端口：

复制一份 php.ini，改名为 php-9001.ini，在里面加 listen = 127.0.0.1:9001
用命令行手动启动：php-fpm -c D:\phpenv\php\php-8.2\php-9001.ini -D（-D 表示后台运行）
同理再启一个监听 9002 的实例，确保三个端口（9000/9001/9002）都处于 LISTEN 状态（可用 netstat -ano | findstr :900 验证）
注意：phpEnv 的「服务管理」界面看不到这些手动进程，关机前得自己 taskkill /PID xxx /F 清理，否则端口被占

Nginx upstream 配置要点（避开 phpEnv 封装陷阱）

phpEnv 的 Nginx 配置文件通常在 D:\phpenv\nginx\conf\nginx.conf，但它的 http{} 块可能被封装在 include 文件里。直接在主配置里写 upstream 容易被覆盖或忽略：

Nginx Hosting

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

下载

不要在 server{} 块内定义 upstream，Nginx 会报错；必须放在 http{} 块顶层（或 include 的子配置中）
后端地址只能写 127.0.0.1:9001 这类 IP+端口，不能写 localhost:9001 或带 http://，否则触发 invalid host in upstream
推荐用 least_conn 算法代替轮询，本地测试时连接数波动更明显，便于观察分发效果

示例片段（插入到 http{} 块中）：

upstream php_backend {
    least_conn;
    server 127.0.0.1:9000 weight=2;
    server 127.0.0.1:9001 weight=1;
    server 127.0.0.1:9002;
}

location 中 proxy_pass 必须对接 FastCGI，不是 HTTP

很多人误以为 proxy_pass http://php_backend 就能转发给 PHP-FPM —— 错。PHP-FPM 不是 HTTP 服务，它只认 FastCGI 协议。Nginx 要用 fastcgi_pass，不是 proxy_pass：

在 location ~ \.php$ {} 块里，把原来的 fastcgi_pass 127.0.0.1:9000 改成 fastcgi_pass php_backend
同时保留所有必要 fastcgi_param，尤其是 SCRIPT_FILENAME，否则会 502 或 404
别删掉 include fastcgi_params;，phpEnv 的这个文件里已预设了关键变量
改完执行 nginx -t 校验语法，再 nginx -s reload —— phpEnv 界面的「重载配置」按钮有时不生效，必须命令行操作

验证请求是否真被分发（别信日志，看响应头）

Nginx access.log 只记录代理动作，看不出 PHP 实际在哪台 FPM 上执行。最可靠的方式是在每个 PHP-FPM 实例对应的网站根目录下，放一个带标识的 info.php：

在监听 9000 的站点里：header('X-PHP-Port: 9000');
在监听 9001 的站点里：header('X-PHP-Port: 9001');
用 curl 或浏览器开发者工具看响应头：curl -I http://localhost/info.php，反复执行，观察 X-PHP-Port 是否变化
如果始终固定为一个值，说明 upstream 没生效，大概率是 fastcgi_pass 写成了 proxy_pass，或者端口没真正监听成功