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

• 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.

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会话。

Xdebug Simple DBGp client (0.10.0)
Copyright 2002-2007 by Derick Rethans.
- libedit support: enabled
     
Waiting for debug server to connect.

Connect


  
  
  
  <

(cmd)

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

• 当参数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.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.remote_host 
  Type: string, Default value: localhost
  选择调试客户端运行在那个主机上，这个选项可以使用主机名或者是IP地址。如果xdebug.remote_connect_back选项指定了的花该选项将会被忽略。

• Log opened at 2007-05-27 14:28:15
    -> 相关函数