phpEnv不支持Node.js托管，因其仅集成Apache/Nginx+PHP-FPM，无内置Node运行时或反向代理配置；需手动在httpd-vhosts.conf中添加ProxyPass规则并启用mod_proxy模块，才能将请求如/api代理至127.0.0.1:3000。
phpEnv 本身不支持 Node.js 站点托管 —— 它是 PHP 集成环境，底层绑定 Apache/Nginx + PHP-FPM，没有内置 Node.js 运行时或反向代理自动配置。 想用 phpEnv 跑 Node.js 服务（比如 Vue CLI 开发服务器、Express API），必须手动桥接，否则直接访问会 404 或返回源码文本。
为什么 phpEnv 启动的站点打不开 Node.js 服务
常见现象：你在 localhost:8080 启了 node server.js，但通过 phpEnv 控制面板添加的“站点”访问时，要么空白，要么显示原始 JS 文件内容，甚至报 502/503。这是因为：
- phpEnv 的站点管理只识别
.php请求，并转发给 PHP-FPM；对GET /api这类非 PHP 路径，默认由 Apache 返回 404 或静态文件 - Node.js 服务默认监听
127.0.0.1:3000，而 Apache 不会主动把请求代理过去，除非你显式配置ProxyPass - phpEnv 的图形化界面里没有“反向代理设置”入口，所有代理逻辑需手动改 Apache 配置文件
在 phpEnv 中启用 Node.js 代理的实操步骤
以让 http://myapp.local/api 代理到本地 http://127.0.0.1:3000 为例（假设你的 Node.js 服务已运行）：
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 打开 phpEnv 安装目录 →
Apache/conf/extra/httpd-vhosts.conf，找到你站点对应的<VirtualHost *:80>块 - 在
<Directory>外、</VirtualHost>前插入以下三行（注意顺序和空格）：ProxyPreserveHost On ProxyPass /api http://127.0.0.1:3000/ ProxyPassReverse /api http://127.0.0.1:3000/
- 确保 Apache 已加载
mod_proxy和mod_proxy_http：检查Apache/conf/httpd.conf中这两行未被注释：LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so
- 重启 phpEnv 的 Apache 服务（控制面板点“重启”或命令行执行
httpd -k restart）
混合开发时容易踩的坑
实际连通后仍可能失败，关键排查点：
立即学习“PHP免费学习笔记（深入）”；
-
node进程必须监听127.0.0.1（不是localhost或0.0.0.0），否则 Windows 防火墙或某些 Node 框架（如 Next.js dev server）会拒绝来自 Apache 的代理连接 - 如果 Node.js 服务用了 CORS 中间件（如
cors()），要显式允许http://myapp.local，否则浏览器控制台报跨域，但代理本身是成功的 - phpEnv 默认关闭
AllowOverride All，如果你在项目根目录放了.htaccess试图做重写，它不会生效 —— 必须去httpd-vhosts.conf里手动加AllowOverride All到对应<Directory> - Windows 下若用 WSL2 开发，
127.0.0.1:3000对 phpEnv（运行在 Windows 主机）不可达，得换用主机 IP（如192.168.x.x）并确认端口开放
真正要跑全栈混合项目，phpEnv 只能当 PHP 部分的容器；Node.js 部分始终是独立进程，代理只是粘合层。别指望它像 Docker 那样统一编排，也别在 phpEnv 界面里找“启动 Node.js”按钮 —— 那个按钮根本不存在。
