使用vscode的remote-ssh进行远程php调试

最新推荐文章于 2025-10-29 16:09:53 发布

原创最新推荐文章于 2025-10-29 16:09:53 发布 · 1.1k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#docker #php #xdebug #vs code

本文介绍了如何使用VS Code的Remote-SSH扩展进行远程PHP开发，通过Docker容器中的Xdebug实现调试。Remote-SSH原理是在远程主机上安装VS Code Server，通过SSH通道实现本地调试体验。配置关键在于不需设置xdebug.remote_host，并且VS Code Server作为代理，使得配置简化。由于Docker的22端口通常被占用，SSH需映射到其他端口（如10022）。

首先转载vscode的remote-ssh扩展，官方文档如下，可以参照下面进行安装

https://code.visualstudio.com/docs/remote/ssh

为什么需要远程开发

在Visual Studio代码远程- SSH扩展允许你打开任何远程计算机，虚拟机或容器上的远程文件夹与正在运行的SSH服务器，并充分利用VS代码的功能集。一旦连接到服务器，您就可以与远程文件系统上任何位置的文件和文件夹进行交互。

由于扩展直接在远程计算机上运行命令和其他扩展，因此无需在本地计算机上使用源代码即可获得这些好处。

上面是文档的原文，有点啰嗦，简单的说就是可以让你把开发环境全部安装在docker里面，通过远程编辑，调试，提交我们的代码。这对于大规模开发的好处是显而易见的，我们可以把开发环境用docker做好，分发给各个开发人员，能够显著提高效率。

remote-ssh的原理

SSH Architecture

remote-ssh会在远程主机上安装一个vs code server，通过这个ssh通道与vscode交互。可以让vscode达到本地调试的效果

远程调试php代码

1.remote-ssh的安装参照上面的文档

2.docker上安装php的xdebug插件，php配置如下

[xdebug]
xdebug.remote_enable = 1
xdebug.remote_autostart = 1

不需要设置xdebug.remote_host，因为对于php来说就是本地调试

3..另外需要php debug插件，安装方法自己搜索，配置如下

        {
            "name": "Listen for XDebug",
            "type": "php",
            "request": "launch",
            "port": 9000
        },

不需要配置pathMappings，就和本地调试一样，方便吧。

这2个配置让我烦恼了半天，弄明白vs code server的功能后才知道改这样配置，核心就是vs code server帮你做了代理，所以配置和本地调试一样。

需要注意的是对于docker来说，22端口已经被主机使用了，ssh需要映射到其他端口，比如10022