PHP解释器路径必须手动填绝对路径，不能依赖PATH；需用which php或where php获取真实路径，在Settings→PHP→Interpreter中手动添加，并确保CLI php.ini启用Xdebug且端口为9003，同时配置服务器路径映射与Composer路径。
PHP解释器路径必须手动填绝对路径，不能依赖PATH
PhpStorm 启动时不会加载你 shell 里配置的 PATH，尤其 macOS 用 Dock、Windows 用快捷方式启动时，which php 在终端能用，但 PhpStorm 根本找不到 php。直接报错 “Cannot run program 'php'” 或 Interpreter 显示为空。
- 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到完整路径，例如：/opt/homebrew/bin/php、C:\php\php.exe、C:\phpstudy_pro\Extensions\php\php8.2.12\php.exe - 进 Settings → Languages & Frameworks → PHP → Interpreter → 齿轮 → Add → Local → 点右侧文件夹图标，**手动浏览选中该路径下的可执行文件**，别点“Auto-detect”
- 选完后右下角必须显示类似
PHP 8.2.12 (cli)，否则说明路径无效：可能权限不足（Linux/macOS 需chmod +x）、路径含中文/空格、或文件根本不是 PHP 二进制（比如误选了php.ini）
CLI php.ini 和 Web php.ini 是两套配置，Xdebug 必须装在 CLI 的那个里
你在浏览器里打开 phpinfo() 看到 Xdebug 已启用，不代表 PhpStorm 能调试——它调用的是 CLI 模式下的 PHP，读的是 CLI 对应的 php.ini，不是 Apache/Nginx 的那个。
- 在 PhpStorm 内置 Terminal 里运行
php --ini，确认输出里 “Loaded Configuration File” 指向哪个文件，常见路径：/etc/php/8.2/cli/php.ini（Ubuntu）、/opt/homebrew/etc/php/8.2/php.ini（Mac Homebrew）、C:\php\php.ini（Windows） - 编辑这个 CLI 的
php.ini，加入 Xdebug 3 最小配置（注意不是旧版xdebug.remote_*）：zend_extension=xdebug<br>xdebug.mode=debug<br>xdebug.client_host=127.0.0.1<br>xdebug.client_port=9003
- 改完保存，重启 PhpStorm，再在 Terminal 里跑
php -m | grep xdebug，有输出才表示扩展真正加载成功
服务器路径映射不匹配，会导致 Debug 断点不触发
即使 PHP 解释器和 Xdebug 都配对了，断点仍不生效，大概率是 Servers 里的路径映射没对上——PHPStorm 调试时靠这个映射把本地文件路径转成浏览器请求的 URL 路径，映射错就找不到源码。
- 进 Settings → Languages & Frameworks → PHP → Servers → “+” 添加服务器，Host 填
localhost，Port 填实际 Web 服务端口（通常是80或8080） - 务必勾选
Use path mappings，然后添加映射项：
— 本地路径：填你项目根目录的**绝对路径**，如D:\phpstudy_pro\WWW\myapp或/Users/name/project
— Web 路径：填对应 URL 中的路径部分，如/myapp或/（如果项目直接放在 Web 根目录） - 验证方式：在浏览器访问
http://localhost/myapp/test.php，同时 PhpStorm 里打开同名文件设断点，刷新页面看是否停住
Composer 路径也要单独配，不能指望自动识别
PhpStorm 的 Composer 支持默认不读取你的 shell PATH，所以即使终端里 composer -V 正常，PhpStorm 里右键 “Run composer command” 还是报 command not found。
立即学习“PHP免费学习笔记（深入）”；
- 进 Settings → Languages & Frameworks → PHP → Composer
- 勾选
Use composer executable，然后填which composer输出的路径，例如：/opt/homebrew/bin/composer、C:\phpstudy_pro\Extensions\composer\composer.bat - Windows 用户特别注意：路径不能含空格（如
C:\Program Files\...），否则静默失败；Scoop 安装的 composer 推荐用scoop shims目录下的composer.bat
