phpEnv中Nginx跨域需修改vhosts下站点配置文件（如default.conf），配置location与proxy_pass实现反向代理，并添加X-Real-IP等必要头信息，重启Nginx生效；常见失败原因包括后端未监听127.0.0.1、防火墙拦截或端口冲突。
phpEnv 是 Windows 下的集成环境，自带 Nginx，但它的默认配置不启用反向代理，也不能直接处理跨域——不是它不行，而是默认没配。只要改对 nginx.conf 或站点配置文件里的 location 和 proxy_pass，就能让前端请求（比如 http://localhost:80）无缝转发到后端（比如 http://127.0.0.1:3000），浏览器全程看到的都是同源地址，根本不会触发跨域拦截。
确认 phpEnv 的 Nginx 配置入口在哪
phpEnv 的 Nginx 配置通常分散在两个位置，容易找错：
-
C:\phpEnv\phpEnv\nginx\conf\nginx.conf：全局主配置，一般不建议直接改这里，容易影响其他站点 -
C:\phpEnv\phpEnv\nginx\vhosts\下的*.conf文件：每个站点一个配置，比如default.conf或你自定义的域名配置，这才是该动的地方 - 改完必须用 phpEnv 控制面板「重启 Nginx」或命令行执行
nginx -s reload，只点「保存」不生效
写对 location + proxy_pass 才能转发成功
常见错误是路径拼接错，导致后端收不到正确 URL 或返回 404。关键看 proxy_pass 末尾有没有 /：
- 前端调用
/api/users，想转给http://127.0.0.1:3000/api/users→proxy_pass http://127.0.0.1:3000/;（结尾有/，自动剥离/api/前缀） - 前端调用
/api/users，后端实际监听的是http://127.0.0.1:3000/v1/users→ 用rewrite改写路径：rewrite ^/api/(.*)$ /v1/$1 break;，再配proxy_pass http://127.0.0.1:3000;（结尾无/） - 别漏掉必要头信息，否则后端可能拿不到真实 IP 或协议：
proxy_set_header X-Real-IP $remote_addr;、proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;、proxy_set_header X-Forwarded-Proto $scheme;
为什么改了还是报跨域？先查这三处
phpEnv 环境下最容易被忽略的三个硬性限制：
立即学习“PHP免费学习笔记（深入）”；
- 后端服务（如 Node.js、Spring Boot）绑定的是
127.0.0.1而非0.0.0.0，Nginx 从本地转发时可能连不上——检查后端启动日志，确认监听地址包含0.0.0.0:3000或至少127.0.0.1:3000 - Windows 防火墙或安全软件拦截了 3000、8080 这类非标准端口，Nginx 转发时超时 —— 临时关闭防火墙测试，或添加入站规则放行目标端口
- phpEnv 自带的 PHP-FPM 模块和 Nginx 共用 9000 端口，若你手动启了另一个服务占了 9000，会导致 Nginx 启动失败却不报错 —— 用
netstat -ano | findstr :9000查端口占用
真正卡住的地方往往不在配置语法，而在 Windows 环境下服务间的可见性：Nginx 能 ping 通 127.0.0.1，不代表它能连上你本地跑着的 Express 或 Laravel 开发服务器——务必先用 curl http://127.0.0.1:3000/api/test 在 phpEnv 的命令行里验证通路，再调 Nginx。
