PHPEnv配置Nginx域名分流指南

phpEnv虽为Windows下便捷的PHP集成环境，但其自带的Nginx默认并不支持多域名分流——所有请求均被统一导向同一站点，根源在于未启用vhost配置、server_name设为通配符“_”且不解析hosts中的多域名映射；本文手把手教你通过手动创建vhost配置文件、在nginx.conf中启用include机制、精准设置server_name与root/proxy_pass，并配合hosts修改、DNS缓存清理及Nginx语法校验与重启，实现dev.test本地运行Laravel、api.test反向代理至Node.js等真实开发场景的域名级流量分发，同时揭示常见404/502陷阱背后的三重元凶：hosts失效、DNS缓存残留与后端服务未就绪。

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：

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 配错了。

今天关于《PHPEnv配置Nginx域名分流指南》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！