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 域名分流能力，它只是一个 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\ 下新建两个文件：
立即学习“PHP免费学习笔记（深入）”；
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 配错了。
