Windows PHP环境Azure Web Apps已安装Composer全局路径无法找到

Azure门户为Windows版PHP运行环境Azure Web App安装的Composer扩展，默认不会自动将自身安装目录写入系统全局PATH环境变量，因此全局命令行环境无法检索到composer命令。该现象不属于扩展安装失败，是该扩展的默认配置行为。
当前配置的遗漏点就是未将Composer安装路径加入系统环境变量，需要手动添加，否则只能在Composer批处理文件所在目录下执行命令，无法全局调用。

临时生效（仅当前命令会话有效） #

打开站点的Kudu调试控制台或者远程连接的命令行窗口，根据使用的终端执行对应命令追加路径（以下示例路径请替换为你实际找到的composer.bat所在目录）：

• CMD环境：

set PATH=%PATH%;C:\Program Files (x86)\Composer

• PowerShell环境：

$env:PATH += ";C:\Program Files (x86)\Composer"

执行完成后运行where composer即可正常返回程序路径，可直接全局调用composer命令。该配置在当前命令窗口关闭、站点重启后失效。

永久生效（站点重启、新开会话依然有效） #

1. 登录Azure门户，进入对应Web App的「配置」页面
2. 确认「常规设置」中的平台位数（32位/64位）和当前PHP运行环境一致，避免后续路径匹配错误
3. 在「应用程序设置」板块新增一项配置：
   • 名称：PATH
   • 值：%PATH%;<你的Composer实际安装路径>

   注意：必须保留原有%PATH%内容，仅在末尾追加Composer路径，不要覆盖原有默认值，否则会导致系统内置命令无法正常调用

4. 保存配置后重启站点，后续所有会话都可以全局调用composer命令。

替代方案 #

如果不想修改全局环境变量，调用Composer时直接写全composer.bat的完整路径即可，例如：

"C:\Program Files (x86)\Composer\composer.bat" install

执行效果和全局调用完全一致。

内容的提问来源于stack exchange，提问作者PetriNet Technologies