PhpStorm不运行PHP，仅调用指定的php二进制文件；必须手动配置which php或where php获取的绝对路径，确保CLI php.ini启用Xdebug且端口为9003，并正确设置服务器路径映射与Composer路径。
PhpStorm 不运行 PHP，它只调用你指定的 php 二进制文件；配错路径、环境变量没加载、php.ini 改错位置，都会导致 php -v 报错、phpinfo() 不生效、Xdebug 断点完全不触发。
为什么 PhpStorm 找不到 php 命令
不是 PhpStorm 有问题，而是 GUI 启动时（macOS 从 Dock、Windows 从快捷方式）根本没读取 shell 的 PATH。终端里能跑的 php -v，PhpStorm 内置 Terminal 却报 “command not found”，就是典型表现。
- 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/opt/homebrew/bin/php或C:\php\php.exe - 别信 Settings → PHP → Interpreter 页面里的“自动检测”——必须手动点击齿轮 → Add Interpreter → Local，再浏览选中那个真实路径
- 选完后右下角要显示类似
PHP 8.2.12 (cli)，否则说明路径无效、权限不足，或该php缺依赖（比如 Windows 少msvcr120.dll）
怎么确认 PhpStorm 实际用的是哪个 php.ini
Web SAPI（Apache/Nginx 加载的 PHP）和 CLI（命令行）通常用两套 php.ini，而 PhpStorm 默认调用 CLI 版本——你在 /etc/php/8.2/apache2/php.ini 里加了 Xdebug，对 PhpStorm 完全无效。
- 打开 PhpStorm 内置 Terminal，执行
php --ini，看 “Loaded configuration file” 后面的路径，那就是当前生效的 CLI 配置文件 - 如果显示
none，说明没加载任何配置；如果路径不对，说明解释器指向了另一个 PHP 实例（比如 Homebrew、asdf、源码编译版） - 不同安装方式默认搜索路径不同：
/opt/homebrew/bin/php查/opt/homebrew/etc/php/8.x/php.ini，/usr/local/php-8.2/bin/php则取决于 configure 时的--with-config-file-path
Xdebug 断点不触发的常见原因
点了 “Start Listening for PHP Debug Connections”，断点也打了，但请求一过就没了——大概率是服务器映射没对上，Xdebug 发起的连接被 PhpStorm 当成未知请求丢弃了。
立即学习“PHP免费学习笔记（深入）”；
- 进 Settings → PHP → Servers，添加一个服务器：Host 填
localhost，Port 填 Web 服务实际端口（如 80 或 8080） - 务必勾选
Use path mappings，把项目根目录（如D:\phpstudy_pro\WWW）映射到 Web 路径/（单斜杠，不是空字符串） -
xdebug.client_port必须和 PhpStorm → PHP → Debug → Xdebug → Port 一致，默认是9003（Xdebug 3），不是旧版的9000 - 改完
php.ini后，一定要重启 PhpStorm，再在 Terminal 里跑php -m | grep xdebug确认扩展已加载
最常被忽略的点：CLI 和 Web SAPI 的 php.ini 是两个文件，改错位置等于白改；服务器路径映射必须严格匹配浏览器访问的实际 URL 路径，差一个字符，Xdebug 连接就失败。
