phpEnv配置Nginx根据域名分流到不同后端 phpEnv分发器-php教程-PHP中文网

phpenv自带nginx不自动域名分流，因其默认仅配置一个通配server块（server_name为_），未启用vhost加载且不解析hosts多域名；需手动在conf/vhost/下创建对应.conf文件，添加server块并配置server_name、root或proxy_pass，同时在nginx.conf的http块末尾加入include vhost/*.conf，并执行nginx -t验证后重启。

phpenv配置nginx根据域名分流到不同后端 phpenv分发器

phpEnv 本身不提供 Nginx 域名分流能力，它只是一个 Windows 下的 PHP 环境集成包（含 Apache/Nginx/MySQL/PHP），真正的域名分流必须靠你手动配置 Nginx 的 server_name 和 proxy_pass 实现。

为什么 phpEnv 自带的 Nginx 不会自动按域名分流

phpEnv 安装后默认只启一个 server 块，监听 80 端口、server_name 是 _ 或空，所有请求都落到同一套 root 目录或默认代理。它不解析你本地 hosts 里配的多个域名，也不自动生成多站点配置——这得你自己写。

常见错误现象：
– 在 hosts 里加了 127.0.0.1 dev.test 和 127.0.0.1 test.test，但两个域名都打开同一个 PHP 项目
– 访问 test.test/api 和 dev.test/api 都被转发到 localhost:8080，没区分

phpEnv 的 Nginx 配置主文件通常是 C:\phpEnv\nginx\conf\nginx.conf，子配置一般放在 conf\vhost\ 下（但默认为空）
它默认不加载 vhost/*.conf，需手动在 http 块末尾加 include vhost/*.conf;
修改后必须运行 nginx -t（在 phpEnv 的 nginx 目录下执行）验证语法，再用面板或命令重启 Nginx

手动配置域名分流：两步写死一个 server 块

以本地开发场景为例：让 dev.test 走 PHP-FPM（跑 Laravel），api.test 代理到 localhost:3000（Node.js 后端）。你需要在 conf\vhost\ 下新建两个文件：

dev.test.conf：

server {
    listen 80;
    server_name dev.test;
    root C:/phpEnv/www/dev-test/public;
    index index.php;
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

api.test.conf：

Nginx Hosting

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

下载

server {
    listen 80;
    server_name api.test;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

注意路径分隔符用正斜杠 /，Windows 下 Nginx 也认这个，别用反斜杠
root 路径必须是绝对路径，且结尾不要带斜杠；proxy_pass 末尾是否加 / 决定路径是否透传（推荐不加，避免重写混乱）
如果后端是 HTTPS（如 https://localhost:8001），proxy_pass 必须写全协议，且 Nginx 需开启 ssl 模块（phpEnv 默认已编译）

容易踩的坑：hosts + DNS + 缓存三连击

改完配置，curl -v http://dev.test 还是 404 或连接拒绝？先查这三项：

C:\Windows\System32\drivers\etc\hosts 里必须有对应行，且无多余空格或注释干扰：127.0.0.1 dev.test、127.0.0.1 api.test
浏览器访问前清空 DNS 缓存：ipconfig /flushdns（Windows），否则可能还在用旧解析
Chrome/Edge 会缓存 server_name 匹配结果，强制硬刷新（Ctrl+Shift+R）或用隐身窗口测试
phpEnv 面板里“Nginx 重启”有时不生效，建议直接进 C:\phpEnv\nginx\ 执行：nginx.exe -s stop && nginx.exe

进阶：用 map 实现基于域名的动态 upstream（非必需）

如果你有十几个测试域名，不想每个都写一个 server 块，可以用 map 把 $host 映射成后端地址，再统一用一个 server 处理——但要注意：map 必须定义在 http 块顶层，不能嵌套在 server 里。

在 nginx.conf 的 http 块开头加：

map $host $upstream_backend {
    default "127.0.0.1:8000";
    dev.test "127.0.0.1:9000";
    api.test "127.0.0.1:3000";
    admin.test "127.0.0.1:8001";
}

然后删掉所有独立 server 块，只留一个通配：

server {
    listen 80;
    server_name _;
    location / {
        proxy_pass http://$upstream_backend;
        proxy_set_header Host $host;
    }
}

这种写法省配置文件数量，但调试困难：一旦 $upstream_backend 为空或拼错，Nginx 不报错，只是 502；建议只在域名数 ≥ 5 且后端协议/端口规律性强时才用。

真正难的不是写对配置，而是每次改完都要确认三件事：hosts 是否生效、Nginx 是否重载成功、后端服务是否真在监听那个端口——漏任何一环，都会让你以为是 Nginx 配错了。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！