PHP环境 VirtualBox + Homestead + Xdebug 解决过程

之前本地开发环境一直都是自己搭建的安装好各个软件关联起来就好了或者就是集成软件后来学习 Laravel 框架后官方推荐使用 Homestead 做为开发环境然后从 Laravel China 教程搭建了一套环境 windows 环境 、 Mac 环境。后来换了一次系统后发现 Xdebug 不能用了…事情的起因大概就是这样了

Xdebug 是什么

Xdebug是PHP的扩展，用于协助调试和开发。
它包含一个用于IDE的单步调试器; 它升级了 PHP 的 var_dump()函数;
它为通知，警告，错误和异常添加了堆栈跟踪;
它具有记录每个函数调用和磁盘变量赋值的功能; 它包含一个分析器;
它提供了与PHPUnit一起使用的代码覆盖功能

如果你还在使用 var_dump echo dd 等还是赶紧来使用下 xdebug 吧能提升你的调试效率还能看到各种变量的变化等

Xdebug 安装

关于安装点击这里

如果你是使用的上面的开发环境里面已经集成好了可以通过 phpinfo() 来输出信息

如果你看到下面的信息就是安装成功了

需要注意一下因为我的环境里有 4 个版本的 PHP 所以一定要确认你当前web端访问的那个是哪个版本的PHP 最好的办法就是通过 phpinfo() 来确认如果是从服务里直接执行的 PHP 命令是使用的 php-cli 模式

运行的是默认的 PHP 在我的环境里也就是7.2的而 FPM 执行的是 7.1的 PHP

IDE 与 Xdebug 的通信

IDE 与 Xdebug之间的通信有2种方式

静态绑定客户端

通信流程大概入下图

在上面的配置 xdebug.remote_connect_back = 0

xdebug 在收到调试通知时会读取配置 xdebug.remote_host 和 xdebug.remote_port

默认是 localhost:9000，然后向这个端口发送通知

根据请求动态获取IP

这种通信流程如下

也就是上面的配置把 xdebug.remote_connect_back = 1 即可这个时候将会忽视 remote_host 的配置，以请求来源的 IP 作为 xdebug 响应的 IP

Xdebug 配置

首先找到 PHP 的扩展配置目录不同环境配置不同路径也不同我的路径大概如下

vagrant@homestead:/etc/php$ pwd
/etc/php
vagrant@homestead:/etc/php$ ls
5.6  7.0  7.1  7.2

因为我是使用的 7.1 版本的PHP 所以进入到7.1目录下 /etc/php/7.1/mods-available 在这个目录下会有很多的扩展配置文件

编辑 xdebug.ini 文件这个是我的配置不要直接抄袭有几个参数需要改下

zend_extension=xdebug.so
xdebug.max_nesting_level=512
xdebug.remote_enable=1
xdebug.remote_connect_back=0
xdebug.remote_port=9002
xdebug.scream=0
xdebug.show_local_vars=1
xdebug.idekey=PHPSTORM
xdebug.remote_host=192.168.1.32
xdebug.remote_log = /tmp/xdebug.log

默认端口是 9000 这里我是自己随便改的只要改了后和IDE中设置的端口一致就可以了

你可以改也可以不改另外 日志目录 一定要设置下方便排错

我遇到的问题

我本地是采用的第一种绑定IP的形式，因为我在使用 VirtualBox 虚拟机的时候把网络固定了 192.168.10.1 一直是这个IP

而我本机的IP是 192.168.1.32 当我第一次采用动态获取IP地址的时候调试 xdebug 一直是失败的最后查看下日志发现

Log opened at 2018-10-25 06:46:27
I: Checking remote connect back address.
I: Checking header 'HTTP_X_FORWARDED_FOR'.
I: Checking header 'REMOTE_ADDR'.
I: Remote address found, connecting to 192.168.10.1:9002.
E: Time-out connecting to client (Waited: 200 ms). :-(
Log closed at 2018-10-25 06:46:28
Log opened at 2018-10-25 06:48:51
I: Checking remote connect back address.
I: Checking header 'HTTP_X_FORWARDED_FOR'.
I: Remote address found, connecting to 192.168.1.32:9002.
I: Connected to client. :-)
-> ....

根据上面的第一次错误信息可以看到 xdebug在尝试连接 192.168.10.1 这个地址从虚拟机里直接ping 这个地址是不通的

所以我把本地的ip地址也给固定死了

直接使用了绑定IP的方式你们不要学我，如果哪天ip地址变了也要来改这里

然后重启 FPM 我的版本是 php7.1

1	sudo service php7.1-fpm restart

至此我的问题是解决了总结2点

一、理解原理
二、多看日志

下面就只是一个Xdebug的安装教程方便自己回忆

PHPStorm的配置

设置 PHP 的版本以及 CLI 的版本

不设置也可以如下图：

讲下 Cli Interpreters 的设置

点击后面的 ... 进入
然后添加选择 From Docker, Vagrant,VM,Remote
然后单击选中 Vagrant 因为我是用的vagrant管理虚拟机的（请根据自己的实际情况选择）
然后 Vagrant Instance F... 选择你的 Homestead 目录即可不需要进入目录里比如我的 E:/Homestead
最后他会自己加载到你的PHP-CLI版本信息等