phpEnv如何配置Nginx二级域名 phpEnv子域名转发-php教程-PHP中文网

phpenv需手动编辑nginx真实配置文件（如c:phpenv ginxhosts*.conf），确保nginx.conf含include vhosts/*.conf，并在hosts中逐条绑定二级域名，再配独立server块，windows下不支持泛解析。

phpenv如何配置nginx二级域名 phpenv子域名转发

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 ginxhosts 目录下，每个 .conf 文件对应一个站点
关键验证方式：打开任务管理器 → 查看 nginx.exe 进程的「命令行」列，里面会带 -c "C:... ginx.conf"，那个才是真路径

常见错误现象：phpEnv 界面点“重载配置”没反应，或改了 vhostsdefault.conf 却不生效 —— 很可能它根本没被 nginx.conf 的 include 指令加载。

务必检查 nginx.conf 里是否有这行：

include vhosts/*.conf;

如果没有，加进去；如果路径写成了 ./vhosts/*.conf 或 vhost/*.conf，要按实际目录名修正。

server_name 怎么写才匹配二级域名

Windows 下 DNS 不支持泛解析，所以本地测试只能靠 hosts 文件硬绑定。Nginx 匹配逻辑严格依赖 server_name 值与请求头 Host 字段是否一致。

正确写法示例（配 api.test.com 和 admin.test.com）：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

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;
}
}</p>

注意要点：

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 下唯一稳定路径。

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