PhpStorm本身不运行PHP，必须手动指定本地php可执行文件绝对路径，因其GUI启动不继承shell环境变量；需用which php或where php获取路径，在Settings→PHP→Interpreter中手动添加，并确认CLI php.ini启用Xdebug且服务器路径映射正确。
PhpStorm 本身不运行 PHP，必须手动指定本地 php 可执行文件路径，否则连 php -v 都报错、断点完全不触发。
为什么 PhpStorm 找不到 php 命令
它不继承终端的 PATH 环境变量——尤其是 macOS 从 Dock 启动、Windows 用快捷方式启动时，GUI 进程压根没加载 shell 的配置。
- 先在终端运行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/usr/local/bin/php或C:\php\php.exe - 别信 Settings → PHP → Interpreter 页面里的“自动检测”，必须点击齿轮 → Add Interpreter → Local → 手动浏览并选中该路径
- 选完后右下角要显示类似
PHP 8.2.12 (cli)，否则是路径错、权限不足，或缺失依赖（如 Windows 缺msvcr120.dll）
CLI 和 Web 的 php.ini 是两套配置
PhpStorm 默认调用 CLI 版本，你在 Apache 的 php.ini 里配了 Xdebug，对 PhpStorm 完全无效。
- 在 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 xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003
- 改完重启 PhpStorm，再在 Terminal 里运行
php -m | grep xdebug确认扩展已加载
服务器映射配错，Xdebug 就永远连不上
点了 “Start Listening for PHP Debug Connections”，断点也打了，但就是不中断——大概率是 URL 映射没对上。
立即学习“PHP免费学习笔记（深入）”；
- 进入 Settings → Languages & Frameworks → PHP → Servers
- 添加服务器：Host 填
localhost，端口填实际 Web 服务端口（如 80 或 8080） - 务必勾选
Use path mappings，把项目根目录（如D:\phpstudy_pro\WWW）映射到/或对应 Web 路径（如/myproject） - 映射不一致会导致 Xdebug 发起的调试连接被 PhpStorm 当作未知请求丢弃
最容易被忽略的是：CLI php.ini 和 Web php.ini 分离、GUI 启动不读 shell 环境变量、路径映射必须与浏览器访问的实际 URL 严格一致——三者任一出错，调试就静默失败。
