Windows XAMPP下Symfony Process运行node命令提示未识别问题

• 基于Symfony Process组件调用全局npm类命令，目标执行指令为relaxed htmlFile.html
• 指令在系统CLI中直接运行正常，通过Process组件调用时报错
• 测试最简指令node -v同样触发错误，具体报错信息：

命令"node -v"执行失败，退出码1（通用错误），工作目录为C:\xampp\pro-resume\public，错误输出提示'node' 不是内部或外部命令，也不是可运行的程序或批处理文件。

• 业务场景：基于relaxed.js库实现HTML转PDF功能
• 测试阶段调用代码如下：

$process = new Process(['node', '-v']);
$process->mustRun();
echo $process->getOutput();

if (!$process->isSuccessful()) {
   throw new ProcessFailedException($process);
}

• 运行环境：Windows系统 + XAMPP服务器 + Laravel 9框架 + PHP 8版本

Windows环境下XAMPP启动的Apache/PHP进程，默认不会加载当前登录用户的完整系统环境变量PATH，全局安装的node、relaxed等可执行命令路径不在PHP进程的搜索范围内，因此触发命令找不到的报错。CLI终端可正常执行是因为终端会加载当前用户的完整PATH配置，二者运行时的环境变量配置不一致。

两种方案均可解决问题，优先选择第一种稳定性更高。

方案1：直接传入可执行文件绝对路径（推荐） #

1. 打开系统CLI，执行where node查询node.exe的完整绝对路径，常见返回值为C:\Program Files\nodejs\node.exe
2. 执行where relaxed查询relaxed命令的完整绝对路径，常见返回值为C:\Users\当前用户名\AppData\Roaming\npm\relaxed.cmd
3. 调用Process时直接使用绝对路径，不依赖PATH环境变量搜索，示例代码：

// 测试node版本调用示例
$process = new Process(['C:\Program Files\nodejs\node.exe', '-v']);
// 实际转PDF调用示例，替换为你本机查询到的relaxed绝对路径即可
// $process = new Process(['C:\Users\当前用户名\AppData\Roaming\npm\relaxed.cmd', 'htmlFile.html']);
$process->mustRun();
echo $process->getOutput();

if (!$process->isSuccessful()) {
   throw new ProcessFailedException($process);
}

注意：Windows下npm全局安装的命令后缀为.cmd，调用时必须写全后缀，不能省略为relaxed

方案2：为PHP进程补全PATH环境变量 #

1. 先通过where node获取nodejs的安装目录，常见路径为C:\Program Files\nodejs\
2. 实例化Process对象后、执行命令前，将node所在目录、npm全局包目录追加到进程的PATH变量中，示例代码：

$process = new Process(['node', '-v']);
$process->setEnv([
    'PATH' => getenv('PATH') . ';C:\Program Files\nodejs;C:\Users\当前用户名\AppData\Roaming\npm'
]);
$process->mustRun();
echo $process->getOutput();

if (!$process->isSuccessful()) {
   throw new ProcessFailedException($process);
}

• Windows环境下调用Process不要将命令拼接为字符串传入，必须使用数组形式传参，避免特殊字符转义问题导致执行异常
• 调用relaxed处理文件时，尽量传入文件的绝对路径，不要使用相对路径，避免因工作目录不匹配找不到目标文件
• 如果PHP以Apache服务形式运行，需要确保服务运行账号对node.exe、relaxed.cmd及对应依赖文件有读取、执行权限

内容的提问来源于stack exchange，提问作者Ismayil Mirzayev