Docker环境下使用PHPStorm+Xdebug调试PHP

一、环境说明

本教程使用的Mac，Mac OS和Window环境设置有区别，请根据实际情况做适当修改

本机IP：172.16.127.33
测试域名：dev.squirrel.com
php版本： 7.3
Docker版本信息

Client: Docker Engine - Community
 Version:           19.03.1
 API version:       1.40
 Go version:        go1.12.5
 Git commit:        74b1e89
 Built:             Thu Jul 25 21:18:17 2019
 OS/Arch:           darwin/amd64
 Experimental:      false

Server: Docker Engine - Community
 Engine:
  Version:          19.03.1
  API version:      1.40 (minimum version 1.12)
  Go version:       go1.12.5
  Git commit:       74b1e89
  Built:            Thu Jul 25 21:17:52 2019
  OS/Arch:          linux/amd64
  Experimental:     true
 containerd:
  Version:          v1.2.6
  GitCommit:        894b81a4b802e4eb2a91d1ce216b8817763c29fb
 runc:
  Version:          1.0.0-rc8
  GitCommit:        425e105d5a03fabd737a126ad93d62a9eeede87f
 docker-init:
  Version:          0.18.0
  GitCommit:        fec3683

二、安装Xdebug，并运行PHP7.3的docker镜像启动调试项目

PHP运行环境可以自己根据实际情况安装，务必要安装xdebug模块。这里提供下已经编译好的PHP5.6、PHP7.2、PHP7.3的Docker镜像，所有提供的docker镜像已安装好xdebug模块。

# 5.6
docker push ponycool/php-dev-5.6:1.0
# 7.2
docker push ponycool/php-dev-7.2:1.0
# 7.3
docker push ponycool/php-dev-7.3:1.0

如果有兴趣也可以去DockerHub上自行查看

DockerHub

注意：必须安装xdebug模块

三、配置xdebug

zend_extension="/usr/local/lib/php/extensions/no-debug-non-zts-20180731/xdebug.so"
xdebug.remote_enable = on
xdebug.remote_port=9000
xdebug.remote_handler = "dbgp"
;开发机IP地址
xdebug.remote_host = docker.for.mac.localhost
xdebug.remote_log=/tmp/php/xdebug/remote.log
xdebug.profiler_enable = on
xdebug.profiler_enable_trigger = on
xdebug.profiler_output_name = cachegrind.out.%t.%p
xdebug.profiler_output_dir = "/tmp/php/xdebug/xdebug_profiler"
;设置的函数调用监测信息的输出路径
xdebug.trace_output_dir ="/tmp/php/xdebug/xdebug_trace"
xdebug.show_local_vars=0
xdebug.default_enable=0
xdebug.idekey=PHPSTORM

xdebug.remote_host为宿主机当前网络中的真实IP，可以通过命令ifconfig en0查看。mac环境下可以配置 xdebug_remote_host 为 docker.for.mac.localhost 通过静态的配置去动态的访问宿主IP。

xdebug.remote_port
这里默认是 9000 端口，如果使用php-fpm，需要改一下xdebug远程调试端口，避免和 php-fpm 的 9000 端口冲突

更详细的xdebug配置可以查看官网或者参考本站PHPStorm+Wamp环境下如何进行bug断点调试中xdebug配置的详细解读。
如果使用本站提供的Docker镜像请直接把xdebug.ini文件挂载到镜像中/usr/local/etc/php/conf.d/目录，如果不是使用本站提供的Docker镜像，还需要自行配置xdebug.ini