Vagarnt Virtual配置多YII服务Xdebug
目录
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配置中。
