PhpStorm Terminal 报“Cannot run program 'php'”是因GUI启动未继承shell的$PATH，需在PhpStorm Terminal中运行which php获取路径，手动配置CLI解释器并确保执行权限。
PhpStorm Terminal 里 php 命令报 “Cannot run program 'php'”
这不是 PhpStorm 坏了，而是它压根没读你 shell 里的 $PATH。尤其 macOS 用户用 Dock 图标启动时，~/.zshrc 完全不生效。
别信终端里 php -v 能跑就万事大吉——必须在 PhpStorm 自带的 Terminal 面板 里执行：
-
which php（macOS/Linux）或where php（Windows），拿到真实绝对路径 - 常见路径：
/opt/homebrew/bin/php（Mac Homebrew）、C:\php\php.exe（Windows 便携版）、/usr/bin/php（Ubuntu 系统包） - Settings → Languages & Frameworks → PHP → CLI Interpreter → Add → Local → 用「…」按钮手动选中这个
php文件，不是输名字，也不是选目录 - Linux/macOS 下若提示权限错误，补一句：
chmod +x /path/to/php
Run 按钮点下去只开浏览器，想让它走 Terminal 输出
默认行为是把 PHP 当 Web 脚本处理，走内置服务器；要强制走 CLI，得删掉干扰项并确认解释器已绑定。
- 菜单 Run → Edit Configurations → 左侧展开列表，删掉所有
JavaScript Debug类型的配置（它们会劫持 Run 按钮） - 右键当前 PHP 文件 → Run '
xxx.php'，第一次运行时会弹窗让你选 PHP 解释器，务必选你刚配好的那个 CLI 解释器 - 之后再点绿色 ▶ 或按
Ctrl+R（Windows/Linux）/Cmd+R（Mac），输出就会出现在 Run 工具窗口 里，不是浏览器 - 如果仍跳浏览器，检查文件是否被误设为“HTML 文件类型”：右下角状态栏看文件类型标签，右键 → Override File Type → 选
PHP
想直接在 Terminal 面板里跑 php artisan 或 composer 却提示 command not found
PhpStorm 的 GUI 启动不继承 shell 环境变量，$PATH 里有也没用。
立即学习“PHP免费学习笔记（深入）”；
- Settings → Languages & Frameworks → PHP → Composer → 勾选 Use composer executable
- 填入
which composer的结果，例如：/opt/homebrew/bin/composer（Mac）、C:\Users\Name\scoop\shims\composer.bat（Windows Scoop） - 同理，其他 CLI 工具如
wp、symfony、phpunit都得单独配置路径，不能指望自动发现 - 避免路径含空格：不要用
C:\Program Files\这类路径，Scoop/Chocolatey 安装更稳
Debug 按钮点了没反应，但 Run 是好的
CLI 运行和 CLI 调试是两套独立配置。Run 成功只说明解释器路径对了；Debug 失败，90% 是 Xdebug 没进 CLI 的 php.ini。
- 先在 PhpStorm Terminal 里运行
php --ini，看 “Loaded Configuration File” 是哪个文件——必须改这个 ini，不是 Apache/Nginx 的那个 - 在这个 ini 里确保有且仅有这三行关键配置：
zend_extension=xdebug、xdebug.mode=debug、xdebug.client_host=127.0.0.1（端口默认9003，别硬改成9000） - 检查
extension_dir指向的目录下是否存在xdebug.so（Linux/macOS）或php_xdebug.dll（Windows） - PhpStorm 必须开启监听：菜单栏 Run → Start Listening for PHP Debug Connections（小电话图标亮起才算生效）
最常被忽略的是：CLI 和 Web SAPI 加载的 php.ini 完全不同，改错文件等于白改；还有就是 GUI 启动 PhpStorm 时根本没加载你的 shell 配置，which 一定要在 PhpStorm 自带 Terminal 里跑，不是你 iTerm 或 CMD 里。
