PhpStorm不运行PHP，仅调用本地php二进制文件；配置失败主因是路径错误、环境变量未继承或CLI/Web php.ini不一致，须用which php/where php获取绝对路径，在Settings→PHP→Interpreter中手动指定，并确认CLI php.ini启用Xdebug且xdebug.mode=debug、client_host=127.0.0.1、client_port=9003，再通过Servers配置精准路径映射。
PhpStorm 本身不运行 PHP，它只调用你本地装好的 php 二进制文件；配置失败的绝大多数情况，不是 PhpStorm 坏了，而是路径没对、环境变量没加载、或 CLI 和 Web 用的 php.ini 不是同一个文件。
怎么找对 php 可执行文件路径
别信“自动检测”——GUI 启动的 PhpStorm 压根不继承终端里的 PATH，尤其 macOS 从 Dock 点开、Windows 用快捷方式启动时，which php 或 where php 在终端里能跑，但在 PhpStorm 设置里会找不到。
- 先在终端里运行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，比如/usr/local/bin/php或C:\php\php.exe - 打开 PhpStorm → Settings → Languages & Frameworks → PHP → Interpreter → 点齿轮 → Add Interpreter → Local → 浏览并选中这个路径
- 选完后右下角必须显示类似
PHP 8.2.12 (cli)，否则说明路径无效（权限不足、依赖缺失、或指向了 shell alias 而非真实二进制）
为什么 phpinfo() 和 PhpStorm 里 php -v 显示的扩展不一致
因为 Apache/Nginx 加载的是 Web SAPI 版本的 PHP，而 PhpStorm 默认调用的是 CLI 版本；Xdebug 必须装在 CLI 的 php.ini 里，Web 版本的配置对调试完全无效。
- 在 PhpStorm 内置 Terminal 里运行
php --ini，确认它实际加载的是哪个php.ini（常见路径：/etc/php/8.2/cli/php.ini或C:\php\php.ini） - 编辑那个 CLI 对应的
php.ini，追加 Xdebug 3 配置（注意不是zend_extension=xdebug.so这种旧写法）：
zend_extension=xdebug xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003
php -m | grep xdebug 确认扩展已加载服务器映射配错，断点永远不触发
点了 “Start Listening for PHP Debug Connections”，打了断点，浏览器也装了 Xdebug Helper，但就是不中断——八成是 Servers 里的路径映射没对上，Xdebug 发来的调试请求被 PhpStorm 当作未知来源丢弃了。
立即学习“PHP免费学习笔记（深入）”；
- 进入 Settings → Languages & Frameworks → PHP → Servers → 点 “+” 添加服务器
- Host 填
localhost，Port 填 Web 服务实际端口（如 Apache 是 80，Nginx 是 8080） - 务必勾选
Use path mappings，然后把项目根目录（如/Users/name/project）映射到 Web 可访问路径（如/或/myapp） - 映射关系必须和你浏览器里访问的 URL 严格一致：如果访问的是
http://localhost/myapp/index.php，那 Web 路径就得填/myapp，不能只填/
最常被忽略的一点：Xdebug 3 的 xdebug.client_host 默认值是 localhost，但在某些 Docker 或 WSL2 场景下必须显式设为 127.0.0.1，否则连接直接超时；CLI php.ini 和 Web php.ini 容易混用，改完一定要用 php --ini 和 phpinfo() 分别验证。
