如何在多项目拆分的PHP微服务架构中配置支持跨应用调试的Xdebug

通用Xdebug基础配置（所有环境通用） #

• 统一所有应用的php配置（包括web端和CLI端的php.ini），核心参数保持一致：

xdebug.mode = debug
xdebug.client_host = 127.0.0.1 ;Docker环境可替换为宿主机IP或host.docker.internal
xdebug.client_port = 9003 ;保持和IDE配置的调试端口一致
xdebug.idekey = "PHPSTORM" ;可自定义为NETBEANS/ECLIPSE，所有环境保持同一个值
xdebug.start_with_request = trigger

• 跨HTTP调用场景：发起请求时携带Xdebug触发标识，可在请求头添加XDEBUG_SESSION: 你的统一idekey，或在请求参数后加?XDEBUG_SESSION_START=你的统一idekey。如果使用HTTP客户端封装，可添加全局中间件自动携带该标识，无需每次手动配置。
• 跨CLI调用场景：执行artisan等命令前传入Xdebug环境变量，Linux/macOS执行命令格式为XDEBUG_SESSION=你的统一idekey php artisan 对应命令，Windows环境先执行set XDEBUG_SESSION=你的统一idekey再运行artisan命令，工具程序调用artisan时直接在shell命令中携带该环境变量即可。

各IDE适配配置 #

PhpStorm

• 导入所有应用到同一工作区：点击File > Open，依次选择三个应用的根目录，选择「Attach」附加到当前工作区，不要开启新窗口。
• 配置路径映射：点击File > Settings > PHP > Servers，添加每个应用对应的服务主机，将本地应用目录和服务器上的部署目录一一映射，例如本地/本地代码路径/application-a对应服务器/www/application-a，确保所有应用的路径映射都配置正确。
• 开启调试监听：点击右上角电话形状的「Start Listening for PHP Debug Connections」按钮，启动监听后即可命中所有应用的断点。

NetBeans

• 导入所有应用源文件：右键当前项目选择Properties > Sources，将另外两个应用的根目录添加到「Source Folders」列表中。
• 全局调试配置：点击Tools > Options > PHP > Debugging，将调试端口设置为和Xdebug配置的client_port一致，Session ID填写之前统一设置的idekey。
• 路径映射配置：右键项目选择Properties > Run Configuration > Advanced，添加本地各应用路径到服务器部署路径的映射，保存后启动调试即可。

Eclipse（PDT插件）

• 导入所有应用到工作区：点击File > Import > PHP > Existing PHP Project，依次导入三个应用到同一个工作区。
• 全局Xdebug配置：点击Window > Preferences > PHP > Debug > Installed Debuggers，选中Xdebug点击「Configure」，将调试端口设置为和Xdebug配置一致，IDE Key填写统一的idekey。
• 路径映射配置：打开Debug Configurations，选中对应调试配置项，在「Path Mapping」标签页添加所有应用的本地路径到服务器路径的映射，保存后启动调试即可。

注意事项 #

如果不同应用部署在独立容器/服务中，需确保每个容器内的Xdebugclient_host参数指向IDE所在设备的可访问IP，避免Xdebug无法连接到IDE。

内容的提问来源于stack exchange，提问作者Anonymous