phpstorm不运行php，仅调用本地解释器；需在settings→php→interpreter中手动配置绝对路径（如/opt/homebrew/bin/php），确保显示“php x.x.x (cli)”，并区分cli与web的php.ini，正确配置xdebug及服务器路径映射。
PhpStorm 本身不运行 PHP，它只调用你本地已安装的 PHP 解释器；没配对路径，php -v 在终端能跑，但在 PhpStorm 里点“Run”就报错、断点不触发、phpinfo() 不生效——这几乎全是路径或环境变量没对上导致的。
怎么找到并填对 PHP 解释器路径
PhpStorm 启动时默认不读取 shell 的 PATH，尤其 macOS 从 Dock 启动、Windows 用快捷方式启动时，压根看不到你在终端里配置好的 which php 或 where php 结果。
- 先在终端（不是 PowerShell 或 Git Bash 的子环境，而是原生终端）执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/usr/local/bin/php或C:\php\php.exe - 打开 PhpStorm → Settings → Languages & Frameworks → PHP → Interpreter → 点齿轮 → Add Interpreter → On Local → 手动浏览选中上面那个路径
- 选完后右下角必须显示类似
PHP 8.2.12 (cli)，否则说明：路径错误、权限不足、或该二进制依赖缺失（如 Windows 缺msvcr120.dll）
为什么 phpinfo() 和 CLI 显示的配置不一致
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，追加 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，断点也打了，但就是不中断——最常见原因是服务器映射没对上，Xdebug 发起的调试连接被 PhpStorm 当成未知请求丢弃了。
- 进入 Settings → Languages & Frameworks → PHP → Servers
- 添加新服务器：Name 填
LocalServer，Host 填localhost，Port 填 Web 服务实际端口（如 80 或 8080） - 务必勾选 Use path mappings，把项目根目录（如
D:\phpstudy_pro\WWW）映射到/；如果项目在子目录（如myapp），就映射到/myapp/ - 映射路径必须和浏览器访问 URL 的路径结构严格一致，否则 Xdebug 回传的文件路径无法匹配 PhpStorm 里的源码位置
真正卡住人的地方，往往不是某一步不会做，而是 CLI 和 Web 两套 php.ini 混用、GUI 启动不继承 shell 环境变量、路径映射漏掉斜杠或大小写不一致——这些细节一错，整个调试链就断了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
