如何在 VSCode 中调试 Homestead 中的 Laravel 代码？（XDebug + PHPUnit）

英文原文 / 翻译 / 279 / 0 / 创建于 4年前

在我的文章《调试：配置 VSCode + Xdebug + PHPUnit 》中收到一些很好的反馈后，有几个人请我帮他们在 Laravel Homestead 环境中配置 Xdebug 设置。添加一个虚拟机确实会增加一些复杂性，但是拥有一个适当的调试环境的好处远远大于最初的调试工作。

下面假设你已经为项目安装了 Homestead。

Homestead 中启用 Xdebug

1. SSH 连接到你的 Homestead:

homestead ssh

2. 使用 Homestead 的 `xon` 命令启用 Xdebug:

xon

3. 找到虚拟机的网关 IP。它将会是虚拟机可以和主机通讯的 IP

netstat -rn | grep "^0.0.0.0 " | cut -d " " -f10

我在 Homestead 机器上看到的输出是10.0.2.2；请记住下来，下一步有用。

4. 查看本地 `xdebug.ini` —— Xdebug 配置文件:

php --ini | grep 'xdebug'

我的输出显示 ini 文件在 /etc/php/7.1/cli/conf.d/20-xdebug.ini

5. 配置 Xdebug，使用前面查到的网关作为`xdebug.remote_host`的值:

编辑刚刚定位到的xdebug.ini文件:

sudo vim /etc/php/7.1/cli/conf.d/20-xdebug.ini

确保设置是这样设置的，适合你的网关 IP：

zend_extension=xdebug.so
xdebug.remote_enable=1
xdebug.remote_autostart=1
xdebug.remote_host=10.0.2.2

7. 重启 PHP-FPM 服务

sudo service php7.1-fpm restart

VSCode 配置

1. 安装 PHP Debug 插件

2. 打开 debug 面板

3. 单击 “config” 按钮 (齿轮) 然后选择 PHP

4. 修改默认的 `launch.json` 文件:

请编辑此文件确保填写正确的 localSourceRoot 和 serverSourceRoot:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for XDebug",
            "type": "php",
            "request": "launch",
            "port": 9000
        },
        {
            "name": "Launch currently open script",
            "type": "php",
            "request": "launch",
            "program": "${file}",
            "cwd": "${fileDirname}",
            "port": 9000
        },
        {
            "name": "Listen for XDebug on Homestead",
            "type": "php",
            "request": "launch",
            "pathMappings": {
                "/home/vagrant/Code/tighten-app-homestead": "/Users/jose/Code/tighten-app-homestead"
            },
            "port": 9000
        }
    ]
}