目录

1 下载并安装Xdebug

2 配置PHPstorm，连接虚拟机PHP

3 配置Xdebug

4 建立PHP服务

5 验证服务

6 处理发现的问题

---

1 下载并安装Xdebug

通过命令查询是否安装了xdebug扩展

# php -v

如果版本信息中没有包含xdebug信息，则表示没有安装xdebug扩展

PHP版本信息

通过apt-get安装xdebug

# sudo apt-get install xdebug

安装成功后一般会在/usr/lib/php目录下找到xdebug的扩展文件xdebug.so，如果没有就通过下面这个命令来查找

# sudo find / -name "xdebug.so"

我当时找到好几个目录，就逐个尝试，把xdebug.so填到php.ini后，再通过查看php版本来验证版本是否匹配。因为是配置cli的php.ini文件，所以不需要重启php-fpm。

多个版本的xdebug扩展文件

下面是配置的命令

# sudo vim /etc/php/7.2/cli/php.ini

加入以下内容

[xdebug]

zend_extension="/usr/lib/php/20170718/xdebug.so"

xdebug.remote_enable=1

xdebug.remote_handler=dbgp

xdebug.remote_mode=req

xdebug.remote_host=192.168.10.10

xdebug.remote_port=9000

最终在20170718这个目录跟我的PHP 7.2.11版本成功匹配上，通过查看PHP版本发现xdebug版本是v2.6.1。

在完成cli的php.ini配置后，也需要在fpm的php.ini写入相应的命令，并完成php-fpm的重启。

---

2 配置PHPStorm，连接虚拟机PHP

完成Xdebug扩展安装后，开始连接PHPStorm和虚拟机，打开PHPStorm的设置，搜索并点击PHP，进入PHP设置区域。

php的设置界面

设置PHP版本为7.2，下一步点击...符号，选择PHP的cli命令文件。初始打开一般是空的，需要点击+号，选择要连接虚拟机或本地的php命令。

选择不同端的php命令

点击From Docker, Vagrant, Vm, WSL,Remote... 选项后弹出选择器，接着点击Vagrant 选项，然后第一个目录是选择Vagrantfile所在的目录，选择成功后PHPStorm会自动查找虚拟机的PHP目录，如果查找失败，就要自己选择正确的命令位置。

这里要注意的是，Homestead的Vagrant虚拟机中，会在多个PHP版本中给配置一个默认的PHP版本。配置设置版本的代码在homestead.rb文件中。

选择vagrant目录，以及远程PHP的命令目录 homestead.rb给php_cli命令设置默认的PHP版本

在完成虚拟机PHP路径配置后，配置界面会实时同步PHP的版本信息，需要注意PHP的版本信息以及Xdebug版本信息是否也预期的一致，如果不一致则需要继续检查php脚本路径等。

如果版本信息一致，则继续完成Xdebug扩展文件的填写，填入Debugger Extension输入框中。而下面的配置项则可以不填。

查看PHP版本和Xdebug的版本

3 配置Xdebug

在完成PHP配置后，回到PHP配置界面。

回到php配置界面

选择Debug，进入DBGp Proxy界面，完成Xdebug的连接配置。其中Host是虚拟机的IP地址，IDE key和Port可以通过phpinfo信息中的Xdebug信息中获取到。

配置xdebug连接 xdebug的默认key xdebug的默认端口号

完成xdebug的连接配置后，即可以验证xdebug服务是否生效。回到debug配置的主界面，检查xdebug配置是否准备就绪。无误后点击Validate进行验证。

检查Xdebug配置

在验证界面中输入其中一个服务的本地web目录，输入服务的访问地址。点击Validate开始验证，当所有验证项都通过时，即表示xdebug服务成功开启。校验成功后，即可点击Start Listening按钮，打开Xdebug的监听了。

验证成功校验

---

4 建立PHP服务

接着进入PHP下面的server界面，为第一个PHP服务都建立一个server。目录右边的目录必须为虚拟机中的项目绝对路径。Debugger处选择为Xdebug。

设置多个PHP服务

完成多个PHP服务配置后，回到PHPstorm主界面，点击右上角Edit Configurations...开启PHP应用。在开启应用界面中，需要再次点击Validate来验证Xdebug是否可用。

开启PHP应用 再次验证ＸdeBug是否可用 开始监听

---

5 验证服务

打开浏览器或者API工具，打好断点，开始美妙的开发之旅，再也不用每次调试都要键入exit()来打断点了。优雅又省心。

图片来自在Homestead搭建的开发环境下使用PHPStorm Xdebug进行调试 - 程序员大本营 (pianshen.com)

---

6 处理发现的问题

1、Xdebug的连接，DBGp Proxy配置中，IP地址为vagrant虚拟机连接的IP地址。

homestead.yaml中的IP地址

2、composer无法通过PHPStorm连接虚拟机中的composer脚本，如果宿主机器不安装composer就无法通过PHPStorm来完成依赖包的更新。

3、在通过composer脚本更新依赖包的时候，gmp这个扩展无法通过apt直接进行安装，最后是下载了PHP7.2.11的源码包，在ext目录中找到gmp目录，通过phpize进行安装。在configure时需要判断 php-config的版本是不是跟php_cli脚本同一个版本。

# /usr/bin/phpize

# ./configure --with-php-config=/usr/bin/php-config

# make & make install

将生成的gmp.so扩展文件放入fpm的php.ini配置中。