在Pimcore中安装ecommerce bundle提示找不到php可执行文件如何解决

报错详情：No 'php' executable found, please install the application or add it to the PATH (in system settings or to your PATH environment variable Trace:
报错截图：

步骤1：确认PHP已安装 #

打开终端/命令提示符执行以下命令，验证PHP是否正常安装：

php -v

如果命令返回PHP版本信息，说明已安装，直接进入下一步；如果返回找不到命令，先安装符合你当前Pimcore版本要求的PHP版本（一般要求PHP7.4及以上，建议匹配Pimcore官方文档的版本要求）。

步骤2：将PHP添加到系统环境变量PATH #

根据你使用的操作系统进行配置：

• Windows系统
  1. 定位到PHP安装根目录（包含php.exe文件的文件夹，例如C:\php\）
  2. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  3. 在系统变量列表中找到Path项，点击编辑，新建一条记录，粘贴PHP根目录的完整路径
  4. 依次保存所有配置，重启已打开的终端/命令提示符和Pimcore相关服务，重新执行php -v验证配置是否生效
• macOS/Linux系统
  1. 执行which php获取PHP可执行文件的路径，例如返回/usr/local/bin/php，则PHP目录为/usr/local/bin
  2. 编辑当前用户的shell配置文件（常用的有~/.bashrc、~/.zshrc，如需全局生效可编辑/etc/profile）
  3. 在文件末尾添加以下内容：

  export PATH=$PATH:/你的PHP安装目录路径
  

  4. 执行source 你修改的配置文件路径让配置即时生效，重新执行php -v验证

步骤3：配置Pimcore的PHP CLI路径（可选，系统PATH生效后仍报错可按此操作） #

部分情况下系统PATH配置正常，但Pimcore无法读取到PHP路径，可手动在后台配置：

1. 登录Pimcore后台，进入「Settings」→「System Settings」→「General」设置页
2. 找到PHP CLI Path配置项，填入PHP可执行文件的完整路径，例如Windows填C:\php\php.exe，macOS/Linux填/usr/local/bin/php
3. 保存配置后清空Pimcore缓存，重新尝试安装ecommerce bundle即可。

内容的提问来源于stack exchange，提问作者Kirsten Phukon