PHPStorm需手动配置本地PHP解释器路径，路径错误或权限不足会导致识别失败；应通过which php或where php获取真实路径，在Settings→PHP→Interpreter中添加，并确保CLI的php.ini启用Xdebug且端口为9003。
PHPStorm 本身不运行 PHP，它只调用你本地装好的 PHP 解释器——配置失败，90% 是因为路径没对上，或者根本没装 PHP。
怎么确认 PHP 已装好且能被 PhpStorm 找到
别跳过这步。很多人以为 php -v 在终端能跑，PHPStorm 就一定能用，其实不是。
- 在终端里执行
which php（macOS/Linux）或where php（Windows），拿到的是完整可执行路径，比如/opt/homebrew/bin/php或C:phpphp.exe - 打开 PhpStorm →
Settings / Preferences → Languages & Frameworks → PHP→ 点击Interpreter右侧的齿轮图标 →Add → Local→ 用「…」按钮选中上面那条路径里的php文件 - 如果点完 OK 后版本号显示为空或报错「Cannot run program "php"」，说明路径错了，或者该文件没有执行权限（Linux/macOS 下用
chmod +x /path/to/php） - Mac 用户特别注意：用 Dock 图标启动 PhpStorm 时，它不读
~/.zshrc；改用终端命令open -a PhpStorm启动，才能继承 shell 的 PATH
为什么 test.php 能 Run 却不能 Debug
CLI 解释器和调试器是两套逻辑。配置了 PHP 路径，不代表 Xdebug 就自动生效。
- 先在 PhpStorm 的
Terminal面板里运行php --ini，看它实际加载哪个php.ini—— 很可能和你在浏览器里访问phpinfo()看到的不是同一个文件 - Xdebug 必须装在 CLI 对应的
php.ini里，不是 Apache 或 Nginx 的那个。常见位置：/etc/php/8.2/cli/php.ini（Ubuntu）、/opt/homebrew/etc/php/8.2/php.ini（Mac Homebrew） - 确认扩展存在：
extension_dir指向的目录下得有xdebug.so（Linux/macOS）或php_xdebug.dll（Windows） - Xdebug 3 的最小必要配置只有三行：
zend_extension=xdebug、xdebug.mode=debug、xdebug.client_host=127.0.0.1，端口默认是9003，别写成旧版的9000
Composer 报 command not found 怎么办
PHPStorm 默认不复用你的 shell 环境变量，尤其在 GUI 启动时。它不会自动从 $PATH 里找 composer。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Languages & Frameworks → PHP → Composer，勾选Use composer executable，然后填上which composer的结果，比如/opt/homebrew/bin/composer - Windows 上如果用 Scoop 安装，路径可能是
C:UsersYourNamescoopshimscomposer.bat；别用带空格的路径（如C:Program Files...），PHPStorm 会静默失败 - 如果项目里用了
composer.phar，直接指向那个文件也行，但记得给执行权限（Linux/macOS）或确保关联了正确的 PHP 解释器（Windows）
用 Docker 或 WSL 时最容易漏掉的一件事
路径必须指向宿主机可访问的二进制，不能直接填容器内或 WSL 子系统的路径。
- WSL 用户别填
\wsl$Ubuntuusrinphp—— 这是 Windows 资源管理器的映射路径，PHPStorm 不认；应该配 Remote Interpreter，类型选WSL，让 IDE 自动桥接 - Docker 用户如果想用容器里的 PHP，不要手动填
/usr/local/bin/php，而要选Add → From Docker，再选对应镜像和 PHP 可执行路径 - 本地 PHP 和容器 PHP 是两个世界：一个改了
php.ini，另一个完全不受影响；调试时断点打在哪儿，就得确保那个环境真在跑代码
