docker 环境 配置 xdebug

• 这是我运行容器使用的命令，可以参考，开放的端口888:80在后面需要用到（事实上不开放端口也没法使用），80 是默认配置，registry.cn-hangzhou.aliyuncs.com/w_c_y_929/mynp:1.2 是我使用DockerFile自行制作的，里面包含了nginx php redis

docker run -v /mnt/d/temptest/yandere_article_builder/:/usr/share/nginx/html -v /mnt/d/temptest/nginx/conf/default.conf:/etc/nginx/conf.d/default.conf -p 888:80 --name xdebug-test registry.cn-hangzhou.aliyuncs.com/w_c_y_929/mynp:1.2

• 进入容器
• 使用pecl install xdebug安装xdebug
• 安装完毕以后我们可以看到
• 这时根据图中第三行我们可以知道安装的是 xdebug-3.1.1(xdebug2 和 xdebug3 配置方式有差异)

php.ini 设置

• 进入/usr/local/etc/php/conf.d不同的机器配置文件位置或许有差异，可以使用whereis php查看
• 新建一个配置文件，名称可以自定义，但我看其他的插件配置文件名都是 docker-php-ext-插件名的格式，所以我取名为

docker-php-ext-xdebug.ini

• 在文件中写入

[xdebug]

zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20190902/xdebug.so

这一句或许机器之间有区别，可以根据上图中最后一行的提示填写

• 接着写入

xdebug.mode=debug # debug模式

xdebug.client_port = 9001 #这里填写宿主机调试端口，参考下一条配置，这里填写的应该是调试客户端所设置的端口

xdebug.client_host = 192.168.101.207 #这里填写宿主机IP，我在其他地方看到这里是填写调试客户端所在的IP（有服务器的可以自己验证一下）

xdebug.remote_handler = dbgp

xdebug.idekey = PHPSTORM

client /ˈklaɪənt/ 客户

• xdebug.client_port 是端口，可以自行设置

phpstorm 设置

• 在 文件->设置->PHP->服务器中添加一个设置

• port:888是容器启动时做的端口映射，调试器选择xdebug（废话）

• 在 运行->编辑配置中选择添加新配置

• 选择php远程调试
• 把 通过IDE键筛选调试链接 选上，服务器选择我们刚刚创建的那个服务器，IDE键 填写我们在 docker-php-ext-xdebug.ini 中配置的xdebug.idekey

• 这时我们可以点击图中的验证来看一下配置情况，图中这种情况是配置成功了

• 这时我们就可以愉快的打断点设置了

需要注意的是 发送请求时要带着 名为 XDEBUG_SESSION 值为 PHPSTORM 的cookie才会被xdebug获取到(我用的是 apifox,很好用的软件，安利)