phpEnv不提供图形化反向代理界面，必须手动编辑nginx.conf：在http块定义upstream、在server块配置location /api/ { proxy_pass http://127.0.0.1:3000/; }并添加必要请求头，最后用nginx -t验证语法。
phpEnv 本身不提供图形化反向代理配置界面，它只是一个轻量级的 PHP + Nginx 本地开发环境套件（类似 PhpWebStudy 的精简版），所有反向代理必须手动编辑 Nginx 配置文件实现 —— 这是用户最容易卡住的第一步。
为什么 phpEnv 没有「反向代理」按钮
phpEnv 的设计目标是快速启动 PHP 开发环境，不是生产级运维平台。它没有宝塔那样的站点管理模块，也没有内置反向代理开关。所有 proxy_pass 规则都得直接写进 nginx.conf 或站点对应的 server 块里。
- phpEnv 默认只生成一个全局
server块，监听localhost:80，根目录为www - 它不区分「网站」概念，也就没有「为某个域名单独配代理」的入口
- 如果你看到某些教程说“phpEnv 面板里点反向代理”，那大概率混淆了 phpEnv 和 PhpWebStudy 或宝塔
手动配置 proxy_pass 的三个关键位置
在 phpEnv 安装目录下找到 nginx/conf/nginx.conf，修改前先备份。真正起作用的只有三处：
-
在
http块顶部定义upstream：适合复用后端（如多个 location 共享同一服务）upstream api_backend { server 127.0.0.1:3000; } -
在
server块内加location规则：最常用，比如把/api/转发出去location /api/ { proxy_pass http://127.0.0.1:3000/; }（注意末尾斜杠，影响路径拼接） -
直接替换整个
location /的root行：适用于全站代理（如把整个 phpEnv 站点变成前端静态服务的代理层）location / { proxy_pass http://localhost:5173/; }
常见错误：请求头丢失、404、循环重定向
光写 proxy_pass 不够，Nginx 默认不透传关键请求头，后端服务会拿不到真实 IP 或协议信息，导致鉴权失败、跳转错乱等问题。
立即学习“PHP免费学习笔记（深入）”；
- 必须显式添加：
proxy_set_header Host $host;（否则后端收到的是127.0.0.1） - HTTPS 场景下漏掉：
proxy_set_header X-Forwarded-Proto $scheme;→ 后端生成的 URL 可能仍是http:// - WebSocket 支持需额外两行：
proxy_http_version 1.1;和proxy_set_header Upgrade $http_upgrade; - 路径末尾斜杠不一致：若
proxy_pass http://127.0.0.1:3000（无尾斜杠），而请求是/api/user，Nginx 会转发成http://127.0.0.1:3000/api/user；加了尾斜杠则变成http://127.0.0.1:3000/user
验证和调试最有效的两步
改完配置别急着重启，先做这两件事：
- 执行
nginx -t：检查语法是否合法。phpEnv 的 nginx 二进制通常在nginx/sbin/nginx目录下，路径要写对 - 看
nginx/logs/error.log：所有proxy_pass失败（连接拒绝、超时、上游不可达）都会记在这里，比浏览器 502 更早暴露问题
路径拼接、请求头透传、upstream 定义位置 —— 这三处出错频率最高，且错误现象相似（都是 502 或空白页），但原因完全不同。动手前先确认你要代理的服务确实在本地可访问（curl -v http://127.0.0.1:3000/health），再动 Nginx。
