多个域名共用一个PHP解释器时,必须为每个域名单独配置PhpStorm的Servers映射,因为Servers按Host字符串精确匹配,不自动推断路径关联;Local path可相同,但Web path须严格对应各域名DocumentRoot的相对路径,且IDE Key、Xdebug配置、调试配置中的Server选项均需一一对应。

多个域名共用一个PHP解释器时,必须为每个域名单独配 Servers 映射
PhpStorm 的 Servers 配置不是全局生效的,而是按域名(Host)区分的。你本地开了 loc.rule.com、api.dev、admin.test 三个虚拟主机,就得在 Settings → PHP → Servers 里添加三条独立记录,每条对应一个 Host 值。IDE 不会自动推断“这三个都指向同一份代码”,它只认你填进去的 Host 字符串。
-
Host必须和浏览器访问时 URL 中的域名完全一致(包括大小写、有无 www),比如访问https://www.api.dev,那这里就得填www.api.dev,填api.dev就不匹配 -
Local path可以是同一个项目目录(如E:\www\api),但Web path必须按该域名的实际 DocumentRoot 设置:若api.dev的 ApacheDocumentRoot是E:\www\api\public,则Web path应填/public;若admin.test指向E:\www\admin根目录,则填/ - 没配某条域名 → 访问该域名时断点全失效,控制台报
Cannot resolve path 'E:\www\api\public\index.php' on server,因为 PhpStorm 根本不知道这个Host对应哪段路径
Web path 填错是最常见的断点不触发原因
Web path 不是“网站根 URL”,而是服务器上从 DocumentRoot 到项目入口文件的相对路径。它直接影响 PhpStorm 构造调试请求时的文件定位逻辑。填成 / 看似省事,但只要你的虚拟主机实际 DocumentRoot 不是项目根目录(比如 ThinkPHP8 要求 DocumentRoot 指向 public/),就会导致路径错位。
- 错误示例:项目结构为
E:\www\shop\public\index.php,ApacheDocumentRoot "E:/www/shop/public",却把Web path设为/→ PhpStorm 会认为http://loc.rule.com/index.php对应E:\www\shop\index.php,而真实路径是E:\www\shop\public\index.php,断点自然找不到 - 正确做法:
Web path填/仅当 DocumentRoot 直接指向项目根目录(如 Laravel 旧版或纯 PHP 项目);若 DocumentRoot 指向子目录(如public、web、src),Web path就必须为空或匹配该子目录层级(多数情况就是/,因为 DocumentRoot 已经收窄) - 验证方法:在浏览器打开
http://your-domain.com后,看地址栏 URL 路径部分 ——Web path应该等于这个路径的前缀。例如打开http://loc.rule.com/api/v1/users能正常响应,说明请求进了public/index.php,那Web path就该是/;如果必须访问http://loc.rule.com/public/api/v1/users才行,那Web path就得是/public
Chrome Xdebug Helper 插件必须按域名切换 IDE Key
Chrome 插件不是全局开关,它通过请求头 XDEBUG_SESSION_START=PHPSTORM 触发调试,而这个行为由当前标签页的域名决定。如果你在 loc.rule.com 页面点击插件启用调试,它只会给该域名下的所有请求加这个头;切换到 api.dev 标签页,必须重新点击插件并确认当前域名已选中,否则 Xdebug 不会连接 PhpStorm。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
- 插件右键菜单里显示的 “Debug” 状态是 per-tab 的,不是 per-domain —— 它只看你当前激活的标签页 URL 的 hostname
- 确保每个域名对应的
Settings → PHP → Servers条目里,IDE key和php.ini中的xdebug.idekey一致(默认是PHPSTORM),否则插件传过去的 key 和 PhpStorm 监听的不匹配,连接直接被拒绝 - 如果用了自定义
xdebug.idekey(比如设成API_DEBUG),那 Chrome 插件设置页里的 IDE Key 下拉框必须手动选中API_DEBUG,且对应Servers条目的IDE key也得填一样
调试配置(Run → Edit Configurations)要绑定正确的 Server
每个 PHP Web Page 或 PHP Web Application 调试配置,其 Server 下拉框必须选中与当前调试域名匹配的那条 Servers 记录。它决定了 PhpStorm 用哪套路径映射去解析文件,而不是靠 URL 自动识别。
立即学习“PHP免费学习笔记(深入)”;
- 错误操作:所有调试配置都选同一个
localhostServer,但你实际访问的是admin.test→ 映射关系错乱,断点位置计算错误 - 建议做法:为每个域名建一个专属调试配置,名字就叫
Debug loc.rule.com、Debug api.dev,Start URL填完整地址(如http://loc.rule.com/),Server选对应条目。这样点击绿色虫子图标时,IDE 知道该用哪组映射 - 不用每次手动切配置:Chrome 插件启用后,只要当前页面域名和某个已配置的
Server匹配,PhpStorm 就会自动关联;但首次调试或切换域名时,务必检查右下角状态栏是否显示 “Listening for Xdebug on port 9003 (for ‘loc.rule.com’)” 这类提示

















