phpEnv需手动编辑Nginx真实配置文件（如C:phpEnv ginx hosts*.conf），确保nginx.conf含include vhosts/*.conf，并在hosts中逐条绑定二级域名，再配独立server块，Windows下不支持泛解析。
phpEnv 本身不直接管理 Nginx 的二级域名配置——它只是一个 Windows 下集成 PHP + Nginx + MySQL 环境的便携式套件，底层用的是精简版 Nginx（通常为 nginx-1.20.x 左右），配置文件路径固定、权限受限、不支持 systemd 或自动 reload。
你要配二级域名，本质是改它内置的 Nginx 配置，但必须绕过 phpEnv 图形界面的“伪封装”，手动编辑真实配置文件，并注意 Windows 环境下的特殊约束。
确认 phpEnv 使用的真实 Nginx 配置路径
phpEnv 启动后，实际加载的不是界面上显示的“配置”按钮所指向的假路径，而是：
- 默认配置文件位置：
C:phpEnv ginxconf ginx.conf - 但多数新版
phpEnv（v3.x+）会把站点配置拆到：C:phpEnv ginx hosts目录下，每个.conf文件对应一个站点 - 关键验证方式：打开任务管理器 → 查看
nginx.exe进程的「命令行」列，里面会带-c "C:... ginx.conf"，那个才是真路径
常见错误现象：phpEnv 界面点“重载配置”没反应，或改了 vhostsdefault.conf 却不生效 —— 很可能它根本没被 nginx.conf 的 include 指令加载。
立即学习“PHP免费学习笔记（深入）”；
务必检查 nginx.conf 里是否有这行：
include vhosts/*.conf;
如果没有，加进去；如果路径写成了 ./vhosts/*.conf 或 vhost/*.conf，要按实际目录名修正。
server_name 怎么写才匹配二级域名
Windows 下 DNS 不支持泛解析，所以本地测试只能靠 hosts 文件硬绑定。Nginx 匹配逻辑严格依赖 server_name 值与请求头 Host 字段是否一致。
正确写法示例（配 api.test.com 和 admin.test.com）：
server {
listen 80;
server_name api.test.com;
root C:/phpEnv/www/api;
index index.php;
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;
}
}
<p>server {
listen 80;
server_name admin.test.com;
root C:/phpEnv/www/admin;
index index.php;
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;
}
}注意要点：
-
server_name必须和你在C:WindowsSystem32driversetchosts里写的完全一致（区分大小写、无空格、不带http://） - Windows 路径用正斜杠
/或双反斜杠\，单反斜杠会导致 Nginx 启动失败且报错模糊（如invalid number of arguments in "root" directive） - 多个
server块可共存，但listen 80不能重复绑定（phpEnv默认已占一个，你新增的必须另起server，别动默认块）
为什么 reload 失败或 404？检查这三个地方
改完配置后，phpEnv 界面的「重载」按钮经常失效，必须手动操作：
执行顺序和关键检查点：
- 用管理员权限打开命令提示符，进入
C:phpEnv ginx目录 - 先校验语法：
nginx.exe -t -c conf ginx.conf—— 如果报错，看提示哪一行，重点查root路径斜杠、include路径是否存在、server_name末尾有没有多余空格 - 语法通过后，强制重启：
nginx.exe -s stop & nginx.exe（不能只用-s reload，Windows 下常卡住） - 检查端口占用：
netstat -ano | findstr :80，如果还有别的进程（如 IIS、Skype）占着 80，Nginx 启不动，日志里只写bind() to 0.0.0.0:80 failed
典型 404 场景：Nginx 找到了 server 块，但 root 路径下没有 index.php，且没配 try_files，就会直接返回 404 —— 此时不是域名问题，是路径或入口文件缺失。
泛域名（*.test.com）在 phpEnv 下基本不可用
Windows 的 hosts 文件不支持通配符，你无法写 127.0.0.1 *.test.com。这意味着：
-
server_name *.test.com在 Nginx 里虽能语法通过，但实际请求进不来（因为浏览器发的Host是xxx.test.com，而*.test.com只匹配一级子域，不匹配多级，且 hosts 不解析） - 正则写法
server_name ~^([a-z0-9]+).test.com$理论可行，但phpEnv自带的 Nginx 编译时很可能没开 PCRE 支持（看nginx -V 2>&1 | findstr pcre输出），一启用就启动失败 - 真正想做泛子域，得换方案：用正式域名 + DNS 泛解析 + 公网服务器，
phpEnv只适合本地固定几个二级域名调试
最省事的做法：在 hosts 里逐条加，比如：
127.0.0.1 api.test.com 127.0.0.1 admin.test.com 127.0.0.1 upload.test.com
然后每个都配独立 server 块。看似麻烦，实则是 phpEnv 下唯一稳定路径。
