PhpStorm本身不运行PHP，仅调用本地PHP解释器；必须手动配置绝对路径的PHP可执行文件、CLI版php.ini中启用Xdebug，并在Servers中精确映射Web路径与项目目录。
PhpStorm不运行PHP，只调用本地解释器
这是最常被误解的起点：PhpStorm 本身不是 PHP 运行时，它只是个编辑器。你看到的 php -v 报错、phpinfo() 不生效、断点不触发，90% 都源于没告诉它“用哪个 php”。它不会自动读取终端里的 PATH —— 尤其是 macOS 从 Dock 启动、Windows 用快捷方式启动时，GUI 进程根本没加载 shell 环境变量。
必须手动提供绝对路径：
- macOS/Linux 执行
which php，结果类似/opt/homebrew/bin/php或/usr/local/bin/php - Windows 执行
where php，结果类似C:\php\php.exe或C:\xampp\php\php.exe - 在 PhpStorm 的
Settings → Languages & Frameworks → PHP → Interpreter页面，点击齿轮 →Add Interpreter → Local，**必须手动浏览选择该文件**，不能依赖“自动检测” - 选完后右下角应显示类似
PHP 8.2.12 (cli)；若无，说明路径错误、权限不足，或该php缺少系统依赖（如 Windows 缺msvcr120.dll）
CLI php.ini 和 Web SAPI php.ini 是两套配置
你在 /etc/php/8.2/apache2/php.ini 里开了 Xdebug，对 PhpStorm 完全无效——因为它调用的是 CLI 版本的 PHP，加载的是另一份 php.ini。调试失败的第一怀疑对象永远是这个。
验证当前 PhpStorm 实际加载的配置：
立即学习“PHP免费学习笔记（深入）”；
- 打开 PhpStorm 内置 Terminal，运行
php --ini，看 “Loaded Configuration File” 路径（常见：/etc/php/8.2/cli/php.ini或C:\php\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 确认扩展已加载。
Servers 设置决定调试连接能否被识别
点了 Start Listening for PHP Debug Connections、打了断点、浏览器也装了 Xdebug Helper，但就是不中断？大概率是服务器映射没对上。Xdebug 发起的调试请求带有一个 URL 上下文，PhpStorm 只有在 Settings → PHP → Servers 里配对成功，才会把该请求路由给你的断点。
关键动作：
- 添加 Server，Host 填
localhost（不要填127.0.0.1，除非你明确知道区别） - 勾选
Use path mappings - 将你的项目根目录（如
D:\phpstudy_pro\WWW\myapp）映射到 Web 路径（如/myapp），**不是/，除非你整个项目就是 Web 根目录** - 确保浏览器访问的 URL（如
http://localhost/myapp/index.php）与映射路径一致，否则调试连接会被丢弃
Composer 和内置服务器是可选项，不是必经路径
很多教程默认把 Composer、内置 PHP Server 当作环境标配，其实它们和“让 PHP 代码跑起来”无关。Composer 是包管理工具，内置 Server 是简易替代方案，但你完全可以不用。
真正影响调试和运行的只有三件事：
-
PHP Interpreter路径是否指向真实可用的php二进制 - 该
php对应的 CLIphp.ini是否正确启用并配置了 Xdebug -
Servers映射是否与你实际访问的 URL 完全一致
其余如数据库配置、框架支持、Live Templates，都是锦上添花。初学者最容易卡在第三点——路径映射看着像对了，但少了一个斜杠、多了一个子目录，调试就静默失败。检查时盯住浏览器地址栏和 Servers 表单里的映射关系，一个字符都不能差。
