PHP中利用Xdebug进行远程错误调试

Xdebug提供了客户端与PHP脚本进行交互的接口，这一章将会介绍如何让PHP和Xdebug开启这个特性，并且介绍一些常用的客户端。

概述

Xdebug(远程)调试器允许测试数据结构，步进并且调试你的代码。Xdebug提供了两种协议用于与其进行交互：在Xdebug1.3和2中旧的GDB协议和Xdebug2中实现的DBGp协议。

客户端

Xdebug2 为DBGp协议提供了一个简单的基于命令行的客户端，当然，也有一些其它的客户端实现（免费的和商业的）。我不是这些客户端的作者，所以请到作者的网站寻找使用帮助。

  • Dev-PHP (IDE: Windows)
  • Eclipse plugin, which has been submitted as an enhancement for the PDT (IDE).
  • Emacs plugin (Editor Plugin).
  • ActiveState's Komodo (IDE: Windows, Linux, Mac; Commercial).
  • MacGDBP - Standalone Mac client.
  • NetBeans (IDE: Windows, Linux, Mac OS X and Solaris.
  • Notepad++ plugin (Editor: Windows).
  • WaterProof's PHPEdit (IDE, from version 2.10: Windows; Commercial).
  • Anchor System's Peggy (IDE: Windows, Japanese; Commercial).
  • MP Software's phpDesigner (IDE: Windows, Commercial).
  • PHPEclipse (Editor Plugin).
  • JetBrain'sPhpStorm (IDE; Commercial).
  • Protoeditor (Editor: Linux).
  • tsWebeditor (Editor: Windows).
  • Xored's TrueStudio IDE (IDE; Commercial).
  • VIM plugin (Tutorial) (Editor Plugin).
  • jcx software's VS.Php (MS Visual Studio Plugin; Commercial).
  • XDebugClient - Standalone Windows client.

Xdebug1.3也带有一个基于GDB协议的简单的命令行客户端。

启动调试器

为了启用Xdebug的调试器，你需要在php.ini文件中做一些配置。这些配置包含xdebug.remote_enable用来允许调试器，xdebug.remote_host和xdebug.remote_port指定调试器应该连接到的IP地址和端口号。如果你希望调试器能够在发生错误（php错误或者异常）的时候初始化一个session的话，你需要修改xdebug.remote_mode配置，该配置项允许的值有req（默认）让调试器在所有脚本开始执行的时候初始化session或者是jit让发生错误的时候才初始化一个session。

当完成以上配置之后，你会发现在脚本运行的时候，Xdebug并没有自动的开启一个调试会话。你还需要按照下面的方法激活Xdebug的调试器。

  1. 当从命令行运行脚本的时候，你需要设置一个环境变量，如下面所述

    export XDEBUG_CONFIG="idekey=session_name"
php myscript.php

    你也可以配置xdebug.remote_host, xdebug.remote_port, xdebug.remote_mode和xdebug.remote_handler 这些选项：

    export XDEBUG_CONFIG="idekey=session_name remote_host=localhost profiler_enable=1"

    这里你设置的这些所有的配置项也可以在php.ini文件中进行设置。

  2. 如果你希望通过调试一个通过浏览器访问的脚本，只需要在访问的参数中添加XDEBUG_SESSION_START=session_name作为参数传递即可，再下一章节中你将看到一个调试会话如何从浏览器窗口中工作。
  3. 另一种方法激活xdebug是在浏览器运行时通过安装以下三个浏览器扩展之一。下面的每一个扩展都允许你通过单击个按钮就可以开启调试器。 这些扩展如下：
    • 最简单的Xdebug 
      这个扩展是Firefox上用于使得与IDE一起调试起来更加容易。你可以在https://addons.mozilla.org/en-US/firefox/addon/the-easiest-xdebug/上找到这个扩展.
    • Xdebug Helper for Chrome 
      这个扩展是运行在Chrome浏览器上的，它将会帮助你通过点击一下按钮就可以允许/禁止调试和性能分析T。你可以在https://chrome.google.com/extensions/detail/eadndfjplgieldjbigjakmdgkmoaaaoc找到这个扩展.
    • Xdebug Toggler for Safari 
      这个扩展是运行在Safari上的，允许你在Safari中自动的开始Xdebug调试过程，你可以在Github上找到这个扩展https://github.com/benmatselby/xdebug-toggler.
    • Xdebug launcher for Opera 
      这个扩展是运行在Opera上的，它允许你在Xdebug上开启一个Xdebug会话。

在开始执行脚本之前，首先需要告诉客户端可以接收调试连接，请查看您使用的客户端的文档以获取如何这样去做。要使用绑定的客户端，首先需要 安装 它，安装完成后你可以通过运行命令"debugclient"命令。如果你希望使用GDB命令集去调试你的脚本，你需要确定你使用的是Xdebug1.3绑定的客户端。

当debugclient开始运行之后，它将会显示以下信息，并且等待来自等待直到debug服务器连接到来以便进行初始化：

Xdebug Simple DBGp client (0.10.0)
Copyright 2002-2007 by Derick Rethans.
- libedit support: enabled

Waiting for debug server to connect.

在连接完成后，debug服务器将会显示下面的输出：

Connect
<?xml version="1.0" encoding="iso-8859-1"?>
<init xmlns="urn:debugger_protocol_v1"
      xmlns:xdebug="http://xdebug.org/dbgp/xdebug"
      fileuri="file:///home/httpd/www.xdebug.org/html/docs/index.php"
      language="PHP"
      protocol_version="1.0"
      appid="13202"
      idekey="derick">
  <engine version="2.0.0RC4-dev"><![CDATA[Xdebug]]></engine>
  <author><![CDATA[Derick Rethans]]></author>
  <url><![CDATA[http://xdebug.org]]></url>
  <<opyright><![CDATA[Copyright (c) 2002-2007 by Derick Rethans]]></copyright>
</init>
(cmd)

 

下来你就可以使用 DBGp 文档中描述的命令集进行操作了。 当脚本执行结束的时候，调试服务器将会断开与客户端的连接，并且还原到等待新的连接请求的状态。

连接建立

对于有静态IP、单个开发者

使用Xdebug的远程调试，Xdebug作为一个嵌入到PHP的程序，扮演着客户端的角色，而IDE则作为服务器。下面的动态图展示了连接建立的过程。

  • 服务端的IP为10.0.1.2， 使用HTTP协议，端口为80
  • IDE在IP地址为10.0.1.42的机器上，xdebug.remote_host被设置为10.0.1.42
  • IDE监听9000端口，因此，xdebug.remote_port设置为9000
  • HTTP请求从运行这IDE的服务器上发起
  • Xdebug连接到10.0.1.42:9000
  • 调试开始运行，返回HTTP响应

使用非固定IP，多个开发者

如果使用了xdebug.remote_connect_back指令的话，连接的建立过程是不同的：

  • 服务端的IP是10.0.1.2, 端口为80
  • IDE运行在一个动态IP的计算机上，因此设置xdebug.remote_connect_back为1
  • IDE监听端口 9000， 因此，配置xdebug.remote_port 为9000
  • 发送HTTP请求，Xdebug检测HTTP header中的IP地址
  • 调试开始运行，产生HTTP响应

HTTP调试会话

当使用浏览器进行Debug的时候，Xdebug支持吃用cookie跟踪会话的功能。

  • 当参数XDEBUG_SESSION_START=name被附加到URL地址上，Xdebug将会设置一个名为XDEBUG_SESSION，值为参数XDEBUG_SESSION_START指定的名称的Cookie。这个Cookie的过期时间是一个小时。DBGp协议也会在初始化包中传递一个同样的值，这样就可以连接到设置了idekey属性的客户端了。
  • 当设置了一个名为XDEBUG_SESSION_START的GET（POST）变量或者XDEBUG_SESSION的Cookie的话，Xdebug将会尝试去连接debugcliet
  • 要停止xdebug会话的话，只需要传递一个XDEBUG_SESSION_STOP的参数，然后Xdebug将不会再去尝试连接debugclient。

多用户调试

Xdebug只允许你使用指定的IP地址（xdebug.remote_host）进行远程调试连接.他不会自动的连接回浏览器运行访问的机器IP，除非你是用xdebug.remote_connect_back指令。

如果你的开发者们在同一个服务器上的不同的项目上面进行开发，你可以使用Apache的每个目录中的.htaccess功能指定xdebug.remote_host指令，配置php_value xdebug.remote_host=10.0.0.5。 但是，如果是多个开发者在同样的代码上进行开发的话，.htaccess将无法完成该项功能。

针对这个问题，这里有两个解决方案。第一个是你可以使用DGBp代理，对于如何使用这个代理，请查看多用户调试这篇文章。你可以在 ActiveState的站点 下载这个代理。这里有更多的文档在Komodo FAQ.

第二个方案是可以使用xdebug.remote_connect_back配置项（Xdebug 2.1之后引入）。

相关配置

 

xdebug.extended_info 
Type: integer, Default value: 1

控制Xdebug是否应该强制PHP解释器使用'extended_info'模式；这使得Xdebug可以使用远程调试器对文件或者行设置断点。当对脚本进行堆栈跟踪或者是性能调试的时候通常希望关闭这个选项，因为为PHP增加的一些调试属性将会减慢脚本的执行，影响最终结果。这个属性只能在php.ini文件中设置，不能够在脚本中通过ini_set()函数进行设置。

 

  • xdebug.idekey 
    Type: string, Default value: complex

    控制Xdebug应该传递给DBGp调试处理器那一个IDE key。默认情况下是基于环境配置的。首先，环境变量中的DBGP_IDEKEY会被使用，然后是USER和USERNAME。默认会使用在环境变量中第一次发现的配置值，如果找不到配置，则使用默认的''。如果设置了这个选项，它将会覆盖环境变量的配置。

  • xdebug.remote_autostart 
    Type: boolean, Default value: 0

    通常情况下，你需要使用指定的HTTP GET/POST变量去激活Xdebug的远程调试功能。当这个设置为1的情况下，Xdebug将在脚本执行时总是尝试去连接调试客户端，即使没有设置GET/POST/COOKIE变量。＝

  • xdebug.remote_connect_back 
    Type: boolean, Default value: 0, Introduced in Xdebug > 2.1

    如果允许的话，xdebug.remote_host设置将会被失效，Xdebug将会尝试连接发送HTTP请求的计算机的调试客户端。他将会检查$_SERVER['REMOTE_ADDR']变量，查找所使用的IP地址。请注意，这里没有可用的过滤器，任何连接到webserver的人都可以开始一个调试会话，即使他们的IP地址与xdebug.remote_host并不相同。

  • xdebug.remote_cookie_expire_time 
    Type: integer, Default value: 3600, Introduced in Xdebug > 2.1

    这个选项用于控制调试会话可用的时间。

  • xdebug.remote_enable 
    Type: boolean, Default value: 0

    这个选项控制是否允许远程调试，如果无法建立连接的话脚本将会继续执行，就像这个配置的值为0一样。

  • xdebug.remote_handler 
    Type: string, Default value: dbgp

    这个值可以是php3，用于使用旧式的PHP 3样式的调试输出，gdb用于允许使用GDB的调试器接口或者dbgp协议。DBGp协议是唯一支持的协议。

 代码如下 复制代码

注意: Xdebug 2.1 和之后的版本只支持dbgp协议。
  • xdebug.remote_host 
    Type: string, Default value: localhost

    选择调试客户端运行在那个主机上，这个选项可以使用主机名或者是IP地址。如果xdebug.remote_connect_back选项指定了的花该选项将会被忽略。

  • Log opened at 2007-05-27 14:28:15
  -> <init xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/x ... ight></init>

  <- step_into -i 1
-> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/db ... ></response>
  • xdebug.remote_mode 
    Type: string, Default value: req

选择调试连接什么时候建立。这个选项有两个不同的值:

req 
Xdebug将会当脚本执行开始的时候立即连接到调试客户端。

jit 
Xdebug 只会在脚本发生错误的情况下尝试去连接调试客户端。

  • xdebug.remote_port 
    Type: integer, Default value: 9000

Xdebug用于连接客户端的端口号。默认端口为9000.

相关函数

bool xdebug_break()

给调试客户端发送一个断点，这个函数让调试器在指定的行上设置一个断点

以上是小编为您精心准备的的内容，在的博客、问答、公众号、人物、课程等栏目也有的相关内容，欢迎继续使用右上角搜索按钮进行搜索windows
， http
， 浏览器
， 变量
， ide
配置
xdebug远程调试、php xdebug远程调试、zend xdebug 远程调试、xdebug 远程调试 配置、phpstorm xdebug 调试，以便于您获取更多的相关知识。

时间： 2025-01-21 01:09:11

PHP中利用Xdebug进行远程错误调试的相关文章

FreeBSD中使用串行通信进行远程内核调试

探索在不影响系统性能的情况下,如何远程调试正在目标计算机上运行的 FreeBSD 内核.本文讨论如何使用串行通信端口设置调试环境.如何编译经过修改的内核代码.如何进行调试,并介绍了一些故障诊断提示. 引言 FreeBSD 是从 BSD 衍生而来的高级操作系统,BSD 则是加利福尼亚大学伯克力分校开发的 UNIX 版本.它提供了很高的性能,与其他系统的兼容性更强,并且需要的系统管理更少.FreeBSD 包含了内核级的状态式 (Stateful) IP 防火墙以及许多其他服务,如 IP 代理网关.访

asp中利用xmlhttp实现远程管理数据库

xml|数据|数据库 A Review of Remote Database Administer几年之前, CGI-BIN 模块被用作远程管理数据库.现在, CGI-BIN 用得越来越少了,原因是它运行速度很慢,而且难于维护. 近几年,组件对象模型 (COM) 得到了广泛的运用,不幸的是,在虚拟主机上注册 COM 组件是一件很麻烦的事. 在 .NET 或 J2EE 平台上, 我们可以很方便地开发n层结构的 Web 应用程序.但是对于网站来说,我们有更方便的方法远程管理数据库,例如:运用 XML

Asp中利用xmlhttp下载远程图片、文件，并保存到本地

例2 二进制方式下载远程图片.文件,并保存到本地:  代码如下 复制代码 Private Function GetPicture(X) '获取图片数据     Set xml = Server.CreateObject("Microsoft.xmlhttp")     xml.Open "GET", X, False     xml.Send     GetPicture = xml.ResponseBody     Set xml=Nothing End Func

Linux中利用SRP(安全远程密码)架设FTP服务器

一.SRP简介 SRP全称:Secure Remote PassWord(安全远程密码),它是一个开放源代码认证协议.使用SRP的客户机/服务器不会在网络上以明文或加密的方式传送密码,这样可以完全消除密码欺骗行为.保证口令可以安全地在网络上面传送.基本的思想是,防止有被动或主动网络入侵者使用字典攻击.Standford大学计算机系开发了SRP软件包,提供基于口令认证和会话加密的安全机制,而不需要用户或者是网管参与密钥的治理或分发.SRP为每一个人提供透明的http://www.aliyun.co

利用Xdebug和Komodo调试PHP应用程序

了解Xdebug和Komodo的配置用来在服务器上调试PHP程序. 在编写应用程序时,出色的开发人员使用优秀的工具进行开发和设计.对使用PHP编写基于Web的应用来说同样适用.对PHP应用编程来说两个有用的工具分别是Komodo和Xdebug. Komodo是一个跨平台的集成开发工具,可以使用DBGp协议进行远程PHP应用程序调试.Xdebug是提供了调试支持功能的PHP扩展.使用这两个工具,你可以在你的服务器上远程调试任何PHP应用程序. 第一步,在运行要调试的脚本的服务器上安装Xdebug,

Ubuntu中安装Xdebug调试跟踪程序过程

Xdebug是Ubuntu下调试跟踪php程序的瑞士军刀,在php开发过程中必备的工具,昨在Ubuntu下安装了一下,记录下安装过程. 首先是要有php环境 我是使用利用pecl下载安装,这样省去了手动编译的麻烦 如果没有pecl就安装下php-pear,但是pecl下载的还是源代码,下载完后会自动编译,期间会用到一个phpize的东东,如果没有phpize就安装下php5-dev 本人的整个过程如下- sudo apt-get install php-pear sudo apt-get ins

关于JSP中，中文问题（泛指字符问题），以及常见错误调试手记

js|错误|问题|中文 关于JSP中,中文问题(泛指字符问题),以及常见错误调试手记 sports98写于2001-1-9 序言:在论坛中,生活中,工作中,有不少和我一样属于鸟级的用户,在面对着不明白的问题的时候就盲目了,多交流,多写写日记就好的多了 文章内容关于:2001-01-08日,编写/调试[用户注册程序] 编写环境:WIN2K(简体中文版) server sp2 + TOMCAT4.0 + J2SDK1.3+MYSQL4.0(alpha)检测数据库内容环境:WIN2K(简体中文版) s

在WebService中利用SoapException处理业务流程执行的错误

web|错误|执行 在客户端中调用WebService的方法处理业务流程,如果业务处理程序返回错误,一般我们可以利用返回错误码的方式将处理结果返回给客户段,客户段针对不同的错误码进行相应的错误处理,按照这种处理流程有时候客户端可能需要很多重复的代码来响应不同的错误码,一个简单的例子就是,对于不同的错误码,显示不同的错误消息,有些系统中,业务处理的错误消息可能是放在业务数据库中的,在这种情况下,客户段要显示错误消息,还必须要调用相应的Service获取错误消息. WebService利用SoapE

在opencv中利用findContours进行轮廓检测，程序运行结束时为什么会报中断错误，求解？

问题描述 在opencv中利用findContours进行轮廓检测,程序运行结束时为什么会报中断错误,求解? 代码如下: #include #include #include #include #include #include using namespace cv; using namespace std; //一.将源图片转成单通道的灰阶图片 Mat changeSourceImg(Mat img){ Mat great(img.size(), CV_8U); cvtColor(img, g