推荐代码调试工具 Xdebug

写代码总绕不过需要调试,除了 UnitTest 外,我们还是需要借助 Xdebug 进行调试。

所以今天来说说如何基于本地 Docker 环境下,使用 Xdebug。

这里的使用,是分别整合到 VS Code 和 PHPStorm 下。

推荐代码调试工具 Xdebug

安装 Xdebug

还是基于神级武器 —— Laradock。我们先看看 Laradock 官网是怎么安装 Xdebug。

Install xDebug#

1 - First install xDebug in the Workspace and the PHP-FPM Containers:

a) open the .env file
b) search for the WORKSPACE_INSTALL_XDEBUG argument under the Workspace Container
c) set it to true
d) search for the PHP_FPM_INSTALL_XDEBUG argument under the PHP-FPM Container
e) set it to true

2 - Re-build the containers docker-compose build workspace php-fpm

参考:https://laradock.io/documentation/#install-xdebug

我们修改对应的地方,然后 build,如果出现下面的错误提示:

推荐代码调试工具 Xdebug

尝试添加国内源试试:

RUN  sed -i s@/archive.ubuntu.com/@/mirrors.aliyun.com/@g /etc/apt/sources.list

重新 docker-compose up -d nginx 后,在 Windows / Mac 下用命令 ./php-fpm/xdebug status 查看安装状态:

推荐代码调试工具 Xdebug

配置 Xdebug

目前开发使用 IDE,个人觉得普遍用的最多的就是 VS Code 和 PHPStorm。所以下面就利用这两个 IDE,分别说说如何使用 Xdebug 的。

VS Code

在 VS Code 下,如果没安装 Xdebug 插件,直接搜索安装即可:

推荐代码调试工具 Xdebug

安装后,增加 Xdebug 环境配置:

推荐代码调试工具 Xdebug

这样就会项目的 .vscode 文件夹下多了一个 Xdebug 配置文件 launch.json,我们配置端口号与 php-fpm 下的 Xdebug 一致,我们再配置 pathMappingsdocker 下的项目路径与本地项目路径关联。具体如下:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "XDebug listening to Laradock",
            "log": true,
            "type": "php",
            "request": "launch",
            "port": 9000,
            "pathMappings": {
                "/var/www/myrss": "${workspaceFolder}",
            }
        },
        {
            "name": "Launch currently open script",
            "type": "php",
            "request": "launch",
            "program": "${file}",
            "cwd": "${fileDirname}",
            "port": 9000
        }
    ]
}

好了,我们启动 Xdebug,打印出如下内容,即表示等待请求:

推荐代码调试工具 Xdebug

我们写个 Demo,并设置断点:

Artisan::command('hello', function () {
    $i = 0;
    $i++;

    return "hello".$i;
});

推荐代码调试工具 Xdebug

然后启动 Xdebug,并执行命令:

php artisan hello

我们可以看到很多输入、输出、断点等信息:
推荐代码调试工具 Xdebug

其中我们也能看到此时的变量 $i 处于未初始状态:

推荐代码调试工具 Xdebug

我们在这断点继续往下执行:

推荐代码调试工具 Xdebug

推荐代码调试工具 Xdebug

PHPStorm

在 Mac 或者 Windows 10 下 Docker 的默认 ip 为:10.0.75.1,

我们先增加一个 Server,其中:

  • Name:laradock
  • Host: 10.0.75.1
  • mappings,等同于上文 VS Code 配置的 pathMappings

推荐代码调试工具 Xdebug

然后,可以新建 PHP Remote Debug,其中:

  • Server:关联到我们上面建的 laradock
  • IDE key:和 Laradock‘s php-fpm 中配置的保持一致即可

推荐代码调试工具 Xdebug

好了,我们可以使用 demo,创建断点,运行 Debug 等待请求::

推荐代码调试工具 Xdebug

一样的,执行命令:php artisan hello

推荐代码调试工具 Xdebug

我们继续往下走:

推荐代码调试工具 Xdebug

总结

用好 Xdebug,更加直观的了解方法中每个变量的动态变化,能提高我们跟踪和排查代码的问题所在。至于下一步如何更好的使用 Xdebug,就看各自的实际项目和开发需要了。

参考

  1. Setting up xDebug with PHPUnit using Docker for Mac and PHPStorm https://intellij-support.jetbrains.com/hc/en-us/community/posts/360000229624-Setting-up-xDebug-with-PHPUnit-using-Docker-for-Mac-and-PHPStorm
  2. Laradock + XDebug + MS Code? No problem https://medium.com/full-stack-development/laradock-xdebug-ms-code-no-problem-35a4338deb3f
  3. Laradock的xdebug在vscode上使用的配置 https://www.itread01.com/content/1526278934.html
  4. 如何設定VSCode XDebug在laradock環境上 https://blog.scottchayaa.com/post/2018/10/16/vscode-phpunit-on-laradock/

相关推荐