PhpStorm不自带PHP，必须手动配置系统已安装的CLI解释器绝对路径，并确保对应php.ini启用Xdebug（端口9003）、正确设置服务器路径映射；GUI启动时不继承shell环境变量，需用which php或where php获取真实路径，在Settings→PHP→Interpreter中添加，且右下角须显示PHP版本号。
PhpStorm 不自带 PHP，它只调用你系统里已安装的 php 二进制文件；配置失败的主因不是 PhpStorm 有问题，而是路径没填对、环境变量没继承、或 CLI 的 php.ini 没启用 Xdebug。
怎么确认 PhpStorm 能真正调用到你的 php
别信终端里 php -v 能跑，就以为 PhpStorm 也能用——GUI 启动的 PhpStorm（比如 macOS 从 Dock 点开、Windows 双击快捷方式）压根不读你的 ~/.zshrc 或 PATH。必须手动指定绝对路径。
- 先在终端运行
which php（macOS/Linux）或where php（Windows），拿到类似/opt/homebrew/bin/php或C:\php\php.exe的真实路径 - PhpStorm → Settings / Preferences → Languages & Frameworks → PHP → Interpreter → 齿轮图标 → Add → Local → 浏览并选中上面那个路径
- 选完立刻看右下角是否显示
PHP 8.2.12 (cli)这类字样；不显示说明路径错、权限不足（Linux/macOS 需chmod +x），或该php缺依赖（如 Windows 少msvcr120.dll）
为什么 phpinfo() 显示有 Xdebug，但 PhpStorm 断点不触发
Web SAPI（Apache/Nginx 加载的 PHP）和 CLI（命令行）用的是两套 php.ini 文件。PhpStorm 默认调用 CLI 版本，所以你在 /etc/php/8.2/apache2/php.ini 里配了 Xdebug，对它完全无效。
- 在 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<br>xdebug.mode=debug<br>xdebug.start_with_request=yes<br>xdebug.client_host=127.0.0.1<br>xdebug.client_port=9003
- 改完重启 PhpStorm，再在 Terminal 里运行
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，然后把项目根目录（如/Users/me/project）映射到 Web 路径（如/或/myapp），这个 Web 路径必须和你浏览器访问的 URL 路径一致 - 如果用 phpStudy 或 XAMPP，项目目录通常在
D:\phpstudy_pro\WWW或C:\xampp\htdocs，映射时不能漏掉子目录层级
Composer 报 command not found 怎么办
PhpStorm 默认不复用 shell 的 PATH，GUI 启动时尤其明显。它不会自动从环境变量里找 composer。
- Settings → Languages & Frameworks → PHP → Composer → 勾选
Use composer executable - 填入
which composer的结果，比如/opt/homebrew/bin/composer（macOS Homebrew）或C:\Users\YourName\scoop\shims\composer.bat（Windows Scoop） - 避免填带空格的路径（如
C:\Program Files\...），PHPStorm 会静默失败；如果项目里直接用了composer.phar，就指向那个文件
最常被忽略的其实是路径映射和 CLI php.ini 的对应关系——这两处一错，调试功能就彻底失效，但错误现象又不报具体提示，只能靠逐项验证。
