Docker/容器/VM环境下Xdebug如何配置实现宿主机路径映射

完全可以，Xdebug原生支持容器/虚拟机场景下的宿主机路径映射，不需要额外修改业务代码，根据你使用的Xdebug版本选对应配置即可。

配置方案 #

Xdebug 3.1及以上版本（推荐） #

这个版本之后新增了专门的路径映射配置项xdebug.path_map，天生适配Docker、虚拟机这类宿主机/客户机路径不一致的场景，支持多组路径映射，配置逻辑简单不容易出错，是目前官方推荐的实现方式。
针对你给出的路径示例（容器内路径/app，宿主机对应路径/home/me/project/myapp），直接在Xdebug的自定义配置文件（一般是php的conf.d目录下的xdebug.ini）中加入如下配置：

xdebug.path_map = "/app=/home/me/project/myapp"

配置生效后，Xdebug输出的所有堆栈跟踪、错误日志、调试传输的文件路径，都会自动把匹配到的容器路径前缀替换成宿主机路径前缀，直接拿到正确的宿主机文件路径。
如果有多个项目需要映射，直接用逗号分隔多组映射规则即可，比如：

xdebug.path_map = "/app1=/home/me/project/app1,/app2=/home/me/project/app2"

低版本Xdebug（3.0及以下、Xdebug 2.x） #

低版本没有专门的path_map配置项，单项目场景下可以通过文件名格式配置实现路径替换：

• Xdebug 3.0版本使用xdebug.filename_format配置
• Xdebug 2.x版本使用xdebug.file_link_format配置
  同样针对你的示例场景，配置写法如下：

; Xdebug 3.0
xdebug.filename_format = "/home/me/project/myapp/%s"

; Xdebug 2.x
xdebug.file_link_format = "/home/me/project/myapp/%s"

配置里的%s是Xdebug内置占位符，会自动替换为当前文件相对于项目根目录的相对路径，实现路径拼接。

补充说明 #

• 如果你是配合IDE（PhpStorm、VS Code等）做交互式断点调试，不需要强制修改Xdebug侧的路径配置，直接在IDE的调试设置项里填写对应的路径映射关系即可，IDE会自动完成调试过程中的路径转换，不会影响断点命中。
• 如果需要在命令行、日志文件中直接输出宿主机路径的报错信息、堆栈跟踪，优先使用上面提到的Xdebug侧配置，输出结果会直接完成替换，不需要额外做字符串处理。
• 修改完配置后记得重启php-fpm、CLI常驻进程（Swoole/Workerman等），可以通过php --ri xdebug命令查看当前生效的Xdebug配置，确认映射规则已经正确加载。

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