Vagrant+PHPStorm+XDebug断点调试

一．为自己的php版本选择正确的xdebug版本

 

首先要得到虚拟机运行环境的phpinfo()信息，我是这样做的

在浏览器访问给虚拟机配的域名

 

把phpinfo() 页面的内容Ctrl+A全部选中，Ctrl+C复制，

打开https://xdebug.org/wizard.php

粘贴到该网址的页面的一个空白输入框，点击底下的按钮

 

 

 

成功会出现以下页面信息：

 

 

 

上面给出安装xdebug的9个操作步骤，下面我会根据实际情况和遇到的问题进行讲解

 

二．安装xdebug

第一步 ：点击下载这个压缩包xdebug-2.6.0alpha1.tgz

下载完我们要把它放到虚拟机里面去解压，我自己是放到/tmp目录里面的

执行sudo –i 获取更高的权限

第二步：解压命令：tar -xvzf xdebug-2.6.0alpha1.tgz

第三步：进入解压之后的文件夹 cd xdebug-2.6.0alpha1

第四步：执行phpize 命令

phpize是属于php-devel 中的东西，主要是设定php 外挂模组的一些设定

第五步：执行 ./configure命令

执行结果的最后一行如果出现这个

 

 

 

出现这个错误说明你执行./configure 时 --with-php-config 这个参数配置路径错误导致的。执行以下命令找到php-config的路径

 

 

 

重新执行命令：

./configure --with-php-config=/data/server/php/bin/php-config

第六步：执行make 命令

 

第七步：把xdebug.so复制到指定目录下

 

我们可以看到当前目录下会有modules这个目录

 

 

 

执行命令：cp xdebug.so /data/server/php/lib/php/extensions/no-debug-non-zts-20160303

 

 

 

第八步：vim /data/server/php/etc/php.ini

 

命令模式下按快捷键大写G跳到文件末尾，插入以下内容(可粘贴到xshell里面去)

zend_extension=/data/server/php/lib/php/extensions/no-debug-non-zts-20160303/xdebug.so

xdebug.remote_enable = 1  #开启远程调试

xdebug.remote_connect_back = 1  #如果配置该项就不需要配xdebug.remote_host

xdebug.remote_port = 9001    #远程调试端口

xdebug.idekey = "PHPSTORM"   #调试器的关键字

xdebug.remote_autostart = 1  #远程调试自动启动

xdebug.remote_handler="dbgp"

xdebug.remote_mode="req"

 

第九步：重启服务器 ，例如nginx 根据你实际情况来定）

 

 

三 配置phpstorm

 

点击箭头指向的地方，添加php解释器,我们用的是PHP7.1.5

 

 

 

点击左上角的+ ，选择Remote

 

 

 

在PHP->Debug->DBGpProxy设置如下

 

 

 

在PHP->Servers中设置映射路径

点击+, 建立起相应的的目录映射

 

 

 

四.安装 xdebug helper

Xdebug工作原理

IDE（如PhpStorm）已经集成了一个遵循DBGP的Xdebug插件，当开启它的时候，会在本地开一个Xdebug调试服务，监听在调试器中所设置的端口上，默认是9000，这个服务就会监听所有到9000端口的链接。在PhpStorm中，位于：工具栏 > Run > Start / Stop Listening for PHP XdebugConnetions。

当浏览器发送一个带 XDEBUG_SESSION_START 的参数的请求到服务器时，服务器接受后将其转到后端的php处理，如果php开启了xdebug模块，则会将debug信息转发到客户端IP的IDE的调试端口上。当参数或者cookie信息中不带 XDEBUG_SESSION_START，则不会启动调试。这就为后续在浏览器中添加开关提供了可能。Xdebug的官方给出了一个示例图：很好的展示了相互调用关系。这个示例图是绑定了ip，即使用了固定ip地址，xdebug.remote_connect_back= 0 ，也是Xdebug 的默认方式，这种情况下，Xdebug 在收到调试通知时会读取配置 xdebug.remote_host 和 xdebug.remote_port ，默认是 localhost:9000，然后向这个端口发送通知，这种方式只适合单一客户端开发调试。我们这里配置xdebug.remote_conncet_back=1,可接受多客户端开发调试。

 

xdebughelper是一款chrome插件，和phpstorm、eclipse、netbeans等IDE协同工作方便调试。这个安装很简单，到谷歌商店（）直接安装，或者百度一下。安装好后，在选项里设置IDE为phpstorm就可以了。

 

 

 

五．调试

1.启动xdebug helper：点击xdebug helper图标，选择Debug项，灰色图标变成绿色

 

2. .在phpstorm中将需要调试的代码打上断点(在行号旁边点击一下即可)，点击右上角电话图标开启调试监听，由一头绿一头红变成两头绿即可

 

 

3.用浏览器或者postman访问地址的时候，在phpstorm的debugger窗口可以看到调试信息。Debugger窗口上方的的这些箭头就是断点执行的按钮（如果断点执行完毕则重新访问，再次断点调试）

 

 

把鼠标放到这些按钮上面会出现使用提示

 

 

 

Step Into：单步执行，遇到子函数就进入并且继续单步执行（简而言之，进入子函数）；

Step Over：在单步执行时，在函数内遇到子函数时不会进入子函数内单步执行，而是将子函数整个执行完再停止，也就是把子函数整个作为一步。有一点,经过我们简单的调试,在不存在子函数的情况下是和Step Into效果一样的（简而言之，越过子函数，但子函数会执行）。

 

Step Out：当单步执行到子函数内时，用Step Out就可以执行完子函数余下部分，并返回到上一层函数。