PhpStorm 不运行 PHP，仅调用本地解释器；配置失败主因是路径错误、CLI 的 php.ini 未启用 Xdebug 或服务器路径映射错位；需手动执行 which php 或 where php 获取绝对路径，在 Settings 中指定，并确认 CLI php.ini 已正确配置 Xdebug 及路径映射与访问 URL 严格一致。
PhpStorm 本身不运行 PHP，它只调用你本地已安装的 PHP 解释器；配置失败，90% 是因为路径没对上、CLI 的 php.ini 没启用 Xdebug，或服务器路径映射错位——不是 IDE 有问题，而是它默认不继承终端的 PATH 环境变量。
怎么找到并填对 PHP 解释器路径
别信 Settings 里“自动检测”按钮。PhpStorm 启动方式（Dock / 快捷方式）导致它压根读不到 shell 的 PATH，所以 which php（macOS/Linux）或 where php（Windows）必须手动执行：
- 在终端运行
which php，拿到类似/opt/homebrew/bin/php或C:\php\php.exe的绝对路径 - PhpStorm → Settings / Preferences → Languages & Frameworks → PHP → Interpreter → 齿轮图标 → Add → Local → 用「…」选中刚才那个路径
- 选完后右下角必须显示类似
PHP 8.2.12 (cli)；若为空或报Cannot run program "php"，常见原因是：路径错误、文件无执行权限（Linux/macOS 需chmod +x）、Windows 缺msvcr120.dll等运行时依赖
为什么 CLI 和浏览器里的 phpinfo() 配置不一致
Web SAPI（Apache/Nginx 加载的 PHP）和 CLI（命令行）默认加载两套 php.ini 文件。PhpStorm 调用的是 CLI 版本，所以你在 /etc/php/8.2/apache2/php.ini 里配了 Xdebug，对 PhpStorm 完全无效。
- 在 PhpStorm 内置 Terminal 里运行
php --ini，确认它实际加载的是哪个php.ini（常见路径：/etc/php/8.2/cli/php.ini或C:\php\php.ini） - 编辑那个 CLI 对应的
php.ini，确保extension_dir指向含xdebug.so（Linux/macOS）或php_xdebug.dll（Windows）的目录 - Xdebug 3 最小必要配置只有三行：
zend_extension=xdebug、xdebug.mode=debug、xdebug.client_host=127.0.0.1；端口默认9003，别写成旧版9000 - 改完重启 PhpStorm，再跑
php -m | grep xdebug确认扩展已加载
服务器路径映射配错，断点永远不触发
点了 Start Listening for PHP Debug Connections，打了断点，但就是不中断——大概率是 Servers 映射没对上，Xdebug 发起的连接被 PhpStorm 当作未知请求丢弃了。
立即学习“PHP免费学习笔记（深入）”；
- 进入 Settings → Languages & Frameworks → PHP → Servers → 点「+」添加服务器
- Host 填
localhost，Port 填 Web 服务实际端口（如 Apache 默认80，Nginx 可能是8080） - 务必勾选
Use path mappings，然后把「项目根目录」映射到「Web 访问路径」，例如：
本地路径：C:\phpstudy_pro\WWW\myapp→ Web 路径：/myapp
或/Users/name/project→/project - 映射关系必须和浏览器访问 URL 严格一致，比如你访问的是
http://localhost/myapp/index.php，那 Web 路径就必须是/myapp，不能是/或/test
Composer 找不到命令？别指望它自动读 $PATH
GUI 启动的 PhpStorm 不会复用你的 shell 环境变量，composer 报 command not found 是常态。
- 在终端运行
which composer（macOS/Linux）或where composer（Windows），拿到完整路径，如/opt/homebrew/bin/composer或C:\Users\name\scoop\shims\composer.bat - PhpStorm → Settings → Languages & Frameworks → PHP → Composer → 勾选
Use composer executable→ 填入上面的路径 - Windows 上避免使用带空格的路径（如
C:\Program Files\...），PHPStorm 会静默失败；Scoop 用户优先用shims目录下的.bat文件 - 如果项目根目录有
composer.phar，直接指向它也行，但注意每次更新需手动替换
最易被忽略的其实是环境变量隔离问题：Mac 用户用 Dock 启动 PhpStorm 就不会加载 ~/.zshrc，Windows 用户用快捷方式启动就看不到系统 PATH 里的 php；调试连不上，十次有八次是映射路径和实际 URL 对不上，而不是 Xdebug 没装好。
