phpEnv不提供Node.js安装功能，因其专注PHP生态组件；需手动安装Node.js并配置系统PATH，确保phpEnv服务、Apache及PHP脚本各层级均能识别node命令。
phpEnv 本身不提供 Node.js 安装功能，它只管理 PHP、Apache/Nginx 和 MySQL 等传统 LAMP/LEMP 组件。想在 phpEnv 环境里用 Node.js，必须手动安装并确保 PATH 可见 —— 否则 node 和 npm 命令在 phpEnv 启动的终端或 Web 请求中根本找不到。
为什么 phpEnv 不自带 Node.js
phpEnv 的设计目标是复刻经典 PHP 开发栈，所有组件都围绕 PHP 生命周期构建（比如 Apache 的 mod_php、PHP-FPM 集成）。Node.js 是独立运行时，和 phpEnv 的服务管理逻辑无交集。官方从未声明支持 Node.js，社区也无补丁集成方案。
- phpEnv 的启动脚本（如
phpenv start）不会读取或转发系统级PATH中的 Node.js 路径 - Web 服务器（如 Apache）调用 PHP 脚本时，环境变量继承自服务启动上下文，而非当前用户终端
- 即使你在 CMD/PowerShell 里能跑
node -v，phpEnv 的 Apache 进程仍可能报exec: "node": executable file not found in $PATH
Windows 下让 phpEnv 能调用 node 命令
关键不是“装没装 Node.js”，而是“phpEnv 进程能不能看到它”。最稳的方式是把 Node.js 安装路径硬写进系统环境变量，并重启 phpEnv 服务：
- 用官网
.msi安装包装 LTS 版（如node-v20.13.1-x64.msi），安装时务必勾选Add to PATH - 安装完后，打开“系统属性 → 高级 → 环境变量”，在
系统变量的Path里确认存在类似C:\Program Files\nodejs\的条目 - 关闭所有终端和 phpEnv 窗口，**完全退出 phpEnv 托盘程序**，再重新双击启动 —— 不重启，旧进程不会加载新 PATH
- 验证：在 phpEnv 自带的终端（如有）或 Windows Terminal 里执行
where node，应返回安装路径；再运行phpenv status看服务是否正常
PHP 中 exec('node --version') 仍失败怎么办
这是最常踩的坑：PHP 的 exec 函数默认使用最小化环境，会忽略用户级 PATH。不能靠“我终端里能跑”来判断 Web 场景是否可用：
立即学习“PHP免费学习笔记（深入）”；
- 在 PHP 脚本开头加
putenv('PATH=C:\Program Files\nodejs;C:\Windows\system32');强制指定路径（注意反斜杠要转义或用正斜杠） - 改用绝对路径调用：
exec('C:/Program Files/nodejs/node.exe --version', $output) - 如果用
child_process类库（如roave/php-node），初始化时必须显式传入nodePath选项，否则默认找node命令 - Apache 的
httpd.conf可通过SetEnv PATH "..."注入，但需重启 Apache，且 phpEnv 的封装可能屏蔽该配置
真正麻烦的从来不是装 Node.js，而是让不同进程层级（系统 → phpEnv 服务 → Apache → PHP 脚本）对上同一个 PATH 视图。每漏一层，command not found 就会换种方式出现一次。
