PhpStorm本身不运行PHP，仅调用本地解释器；配置失败主因是路径错误或未安装PHP，须用which php/where php获取真实路径并手动填入Interpreter设置，同时确保GUI启动时继承shell环境变量。
PhpStorm 本身不运行 PHP，它只调用你本地装好的解释器；配置失败，90% 是因为路径没对上，或者根本没装 PHP。
which php 或 where php 拿到的路径必须填进 Interpreter
终端里能跑 php -v，不代表 PhpStorm 就能用 —— GUI 启动时（比如 macOS 从 Dock 点开、Windows 双击快捷方式）根本不读你的 shell 环境变量。
- macOS/Linux 执行
which php，Windows 执行where php，拿到完整路径，例如/opt/homebrew/bin/php或C:\php\php.exe - Settings → Languages & Frameworks → PHP → Interpreter → 齿轮图标 → Add → Local → 用「…」选中上面那条路径里的
php文件 - 选完后右下角必须显示类似
PHP 8.2.12 (cli)，否则就是路径错、权限不足（Linux/macOS 需chmod +x /path/to/php），或缺依赖（如 Windows 缺msvcr120.dll）
php --ini 显示的 cli php.ini 才是 PhpStorm 读的
你在浏览器里访问 phpinfo() 看到的配置，和 PhpStorm 调用的 CLI 版本完全无关。Xdebug 配在 Apache 的 php.ini 里，对 PhpStorm 无效。
- 在 PhpStorm 内置 Terminal 里运行
php --ini，确认它加载的是哪个文件，常见路径：/etc/php/8.2/cli/php.ini（Ubuntu）、/opt/homebrew/etc/php/8.2/php.ini（Mac Homebrew）、C:\php\php.ini（Windows） - 在这个文件末尾加 Xdebug 3 最小配置（别写旧版端口 9000）：
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确认扩展已加载
Servers 里的路径映射不对，Debug 就永远不触发
点了 “Start Listening for PHP Debug Connections”，断点也打了，但程序照常跑完 —— 八成是服务器映射没配对，Xdebug 发来的调试请求被 PhpStorm 当成未知流量丢弃了。
立即学习“PHP免费学习笔记（深入）”；
- Settings → Languages & Frameworks → PHP → Servers → 「+」添加服务器
- Host 填
localhost，Port 填 Web 服务实际端口（如 Apache 默认 80，Nginx 常为 8080） - 勾选
Use path mappings，把项目根目录（如D:\phpstudy_pro\WWW\myapp）映射到 Web 路径（如/myapp） - 映射必须和你浏览器访问的 URL 一致，比如访问
http://localhost/myapp/index.php，那 Web 路径就得是/myapp
Composer 找不到？别信自动检测，填 which composer
PHPStorm 默认不复用你的 $PATH，尤其 GUI 启动时。它不会自己去猜 composer 在哪。
- Settings → Languages & Frameworks → PHP → Composer
- 勾选
Use composer executable，然后填which composer（macOS/Linux）或where composer（Windows）的结果，例如/opt/homebrew/bin/composer - Windows 上若用 Scoop 安装，路径可能是
C:\Users\YourName\scoop\shims\composer.bat；绝对不要填带空格的路径（如C:\Program Files\...），PHPStorm 会静默失败
最容易被忽略的点：macOS 用户用 Dock 启动 PhpStorm 时，它压根不继承 ~/.zshrc；必须用终端命令 open -a PhpStorm 启动，才能让 which php 和 which composer 生效。
