蒙国造博客

PHPStorm调试Docker容器中的PHP项目

本机一直使用docker开发,对于习惯使用调试的人来说,PHP放在docker容器中又多了一层难度。

当然,这只适用于还不懂配置的时候,一旦掌握窍门,其实是简单不过的事情,和本机配置几乎无任何难度差别。

1 环境

开始之前,我们先做一些环境假设:

这里的域名不一定是localhost,如果你用了Laravel、Yii、Thinkphp等框架,那一般会用类似 mydev.comdev.awaimai.comawaimai.dev的域名,本文一样适用。

2 php.ini配置

主要配置如下:

[XDebug]
xdebug.remote_enable = 1
xdebug.remote_handler = "dbgp"
xdebug.remote_host = host.docker.internal

这几行的作用是:

这里我们没有配置xdebug.remote_port,因为xdebug默认使用9000,与我们FPM一致了,不用再设置。如果FPM使用其他端口,remote_port也要改成相应端口。

配置完成后,重启PHP容器

2 PHPStorm配置

1 菜单选择 RunEdit Configurations

2 在弹出的框中点左上角的 + 号,选择 PHP Web Page

3 现在还没有任何的服务器,我们要加一个。如下,点击 server 右侧的 ... 按钮。

4 然后就是配置服务器的信息,这里就是docker容器了。

然后点击OK保存。

5 返回后,

点击OK保存。

3 开始调试

返回代码窗口,在代码前打一个【断点】,再点击【调试按钮】,如下:

PHPStorm就会自动打开浏览器,等程序执行到断点时,自动停止。

这里我们就可以看到PHP中的全局变量、调用栈、临时变量,

并且可以单步调试,非常方便。

退出移动版