Docker for Windows 环境下配置Xdebug调试PHP代码

本文主要讲述了在 Windows10 下使用 Laradock 部署开发环境，配置 Xdebug 调试PHP代码所遇到的步骤及踩过的一系列坑。

开启 Xdebug

在 Laradock(此处我是用的是V10.0)的 .env 文件中，具体参见 Laradock文档：

WORKSPACE_INSTALL_XDEBUG=true
PHP_FPM_INSTALL_XDEBUG=true

然后重新构建容器：

docker-compose build workspace php-fpm

这里我并没有更改 laradock/workspace/xdebug.ini 和 laradock/php-fpm/xdebug.ini， 完全使用默认，也不建议新手对其进行更改。
需要注意的是重新构建容器，容器内需要从外网下载一些依赖文件，由于众所周知的原因，
这可能会花费一些时间。
好在，新版本的 Laradock 设置了 UBUNTU_SOURCE=ustc 这个配置，可以更改其所使用的Linux操作系统的源。这里默认是 中科大的源，可以根据自己的需求更改，具体的可以查看laradock/workspace/sources.sh这个文件。

然后打开 PHPStorm，在File -> Settings -> Lanuages & Frameworks -> PHP -> Servers，新建一个 Server，保存

由于 xdebug 安装在容器中，它进行的调试其实是在容器内部进行的，而编辑器（客户端）在windows上，所以这里需要进行目录映射，否则会报错：

cannot find a local copy of the file …

配置完成后，可以点击这里的检验进行验证

验证结果如下即为配置正确，最后一句的警告可以忽略

接下来就可以开始代码的调试了。