PHP安装配置XDebug

痛定思痛。 2022-05-26 06:10 249阅读 0赞

**1、下载Xdebug**

到目前为止，Xdebug的最新版本为2.4.0，你可以前往[Xdebug官方网站][Xdebug]下载与自己的PHP版本匹配的Xdebug模块文件。

由于笔者使用的是php5.5.12版本，因此下载的Xdebug模块文件为[php\_xdebug-2.2.5-5.5-vc11-nts-x86\_64.dll][php_xdebug-2.2.5-5.5-vc11-nts-x86_64.dll]

**2、安装配置Xdebug**

接着，我们将Xdebug模块文件放入PHP安装目录/ext文件夹中，接着我们在PHP配置文件php.ini中追加如下配置内容：

**\[plain\]** [view plain][] [copy][view plain]

1.  \[Xdebug\]

2.  ;指定Xdebug扩展文件的绝对路径

3.  zend\_extension="d:/wamp/bin/php/php5.5.12/zend\_ext/php\_xdebug-2.2.5-5.5-vc11.dll"

4.  ;启用性能检测分析

5.  xdebug.profiler\_enable=on

6.  ;启用代码自动跟踪

7.  xdebug.auto\_trace=on

8.  ;允许收集传递给函数的参数变量

9.  xdebug.collect\_params=on

10. ;允许收集函数调用的返回值

11. xdebug.collect\_return=on

12. ;指定堆栈跟踪文件的存放目录

13. xdebug.trace\_output\_dir="D:/debug"

14. ;指定性能分析文件的存放目录

15. xdebug.profiler\_output\_dir="D:/debug"

16. xdebug.profiler\_output\_name = cachegrind.out.%t.%p

备注：在上述配置内容中，zend\_extension用于指定Xdebug扩展模块的文件路径(由于Xdebug是基于Zend引擎的扩展，因此必须使用zend\_extension配置指令，而不是extension。zend\_extension指令的配置路径必须是绝对路径)。之后的6个配置语句是Xdebug的配置参数。  
此时，我们重启服务器，通过访问含有phpinfo()函数的PHP文件，即可看到Xdebug模块的相关信息。

**3、配置参数选项附录**

在上面的Xdebug配置中，我们只配置了6个常用的配置选项。当然，Xdebug还支持更多的配置参数，详情见下表。   
配置参数选项

<table style="background:#FFFFFF;"> 
 <tbody> 
 <tr> 
 <td style="background:#EFF3F5;">&nbsp;</td> 
 <td style="background:#EFF3F5;">参数值类型与默认值</td> 
 <td style="background:#EFF3F5;">参数选项描述</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.auto_trace</td> 
 <td style="background:#F7F7F7;">boolean类型，默认值=0</td> 
 <td style="background:#F7F7F7;">是否在脚本运行之前自动调用相关追踪函数。</td> 
 </tr> 
 <tr> 
 <td>xdebug.cli_color</td> 
 <td>integer类型，默认值=0</td> 
 <td>该参数自2.2版本开始引入。如果值=1，当处于CLI模式或连接虚拟控制台时，Xdebug将高亮显示var_dumps()和堆栈输出，；在Windows中，这需要安装ANSICON工具。如果值=2，不管是否处于CLI模式或连接虚拟控制台，Xdebug都会高亮显示var_dumps()或堆栈输出；这种情况下，你可能会看到转义后的代码。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.collect_assignments</td> 
 <td style="background:#F7F7F7;">boolean类型，默认值=0</td> 
 <td style="background:#F7F7F7;">该参数自2.1版本开始引入。用于控制是否为函数跟踪添加变量赋值功能。</td> 
 </tr> 
 <tr> 
 <td>xdebug.collect_includes</td> 
 <td>boolean类型，默认值=1</td> 
 <td>控制是否在跟踪文件中写入include()、include_once()、require()、require_once()等函数中用到的文件名。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.collect_params</td> 
 <td style="background:#F7F7F7;">integer类型，默认值=0</td> 
 <td style="background:#F7F7F7;">控制在调用函数时，是否收集传递给函数的参数信息。如果参数值过大，这可能会占用大量的内存；不过，在Xdebug 2中不会出现该问题，因为Xdebug 2将相关数据写入磁盘中，而不是占用内存。 如果值=0，则不显示任何信息。 如果值=1，只显示类型和大小信息，例如：string(6)、array(8)。 如果值=2，将显示类型和大小，以及全部信息的工具提示。 如果值=3，将显示变量的全部内容。 如果值=4，将显示变量的全部内容和变量名。</td> 
 </tr> 
 <tr> 
 <td>xdebug.collect_return</td> 
 <td>boolean类型，默认值=0</td> 
 <td>控制是否在追踪文件中写入函数调用的返回值。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.collect_vars</td> 
 <td style="background:#F7F7F7;">boolean类型，默认值=0</td> 
 <td style="background:#F7F7F7;">控制是否收集指定作用域中的变量信息。由于需要反向工程PHP的操作码数组，因此Xdebug的分析速度可能比较慢。</td> 
 </tr> 
 <tr> 
 <td>xdebug.coverage_enable</td> 
 <td>boolean类型，默认值=1</td> 
 <td>该参数自2.2版本开始引入。控制是否允许通过设置内部结构来启用代码覆盖率功能。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.default_enable</td> 
 <td style="background:#F7F7F7;">boolean类型，默认值=1</td> 
 <td style="background:#F7F7F7;">当发生异常或错误时，是否默认显示堆栈信息。</td> 
 </tr> 
 <tr> 
 <td>xdebug.dump.*</td> 
 <td>string类型，默认值=Empty</td> 
 <td>这里的*可以是COOKIE, FILES, GET, POST, REQUEST, SERVER, SESSION中的任意一个。用于指定发生错误时是否显示超全局变量数组中的索引变量信息。比如，你想要显示请求的IP地址和请求方式，可以设置为 xdebug.dump.SERVER=REMOTE_ADD,REQUEST_METHOD 多个索引变量用英文逗号隔开，如果要输出其中的所有变量，可以直接用*，例如： xdebug.dump.GET=*</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.dump_globals</td> 
 <td style="background:#F7F7F7;">boolean类型，默认值=1</td> 
 <td style="background:#F7F7F7;">控制是否显示通过xdebug.dump.*定义的所有超全局变量的信息。</td> 
 </tr> 
 <tr> 
 <td>xdebug.dump_once</td> 
 <td>boolean类型，默认值=1</td> 
 <td>如果出现多个错误，控制超全局变量信息是在所有错误中显示，还是只在第一个错误中显示。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.dump_undefined</td> 
 <td style="background:#F7F7F7;">boolean类型，默认值=1</td> 
 <td style="background:#F7F7F7;">控制是否显示超全局变量中未定义的值。</td> 
 </tr> 
 <tr> 
 <td>xdebug.extended_info</td> 
 <td>integer类型，默认值=1</td> 
 <td>是否强制进入PHP解析器的"extended_info"模式，这将允许Xdebug以远程调试器对文件或行添加断点。开启此模式将拖慢脚本的允许速度，该参数只能在php.ini中设置。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.file_link_format</td> 
 <td style="background:#F7F7F7;">string类型，默认值=,</td> 
 <td style="background:#F7F7F7;">自2.2版本开始引入。用于指定堆栈信息中用到的文件名称的链接样式，这允许IDE通过设置链接协议，直接点击堆栈信息中的文件名称，即可快速打开指定的文件。例如：ZendStudio://%f@%l(%f表示文件路径，%f表示行号)。</td> 
 </tr> 
 <tr> 
 <td>xdebug.force_display_errors</td> 
 <td>integer类型，默认值=0</td> 
 <td>自2.3版本开始引入。是否强制显示错误信息。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.force_error_reporting</td> 
 <td style="background:#F7F7F7;">integer类型，默认值=0</td> 
 <td style="background:#F7F7F7;">自2.3版本开始引入。是否强制显示所有错误级别的信息。</td> 
 </tr> 
 <tr> 
 <td>xdebug.halt_level</td> 
 <td>integer类型，默认值=0</td> 
 <td>自2.3版本开始引入。指定出现那些错误级别的错误时，中止程序运行。例如：xdebug.halt_level=E_WARNING|E_NOTICE|E_USER_WARNING|E_USER_NOTICE(也仅支持上述4种错误级别)。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.idekey</td> 
 <td style="background:#F7F7F7;">string类型，默认值=*complex*</td> 
 <td style="background:#F7F7F7;">指定传递给DBGp调试器处理程序的IDE Key。</td> 
 </tr> 
 <tr> 
 <td>xdebug.manual_url</td> 
 <td>string类型，默认值=http://www.php.net</td> 
 <td>仅2.2.1以下版本可用，用于指定从函数堆栈和错误信息链接到的帮助手册的基本URL。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.max_nesting_level</td> 
 <td style="background:#F7F7F7;">integer类型，默认值=100</td> 
 <td style="background:#F7F7F7;">指定递归的嵌套层级数。</td> 
 </tr> 
 <tr> 
 <td>xdebug.overload_var_dump</td> 
 <td>boolean类型，默认值=1</td> 
 <td>自2.2版本开始引入，当php.ini中的html_error设为1时，Xdebug是否默认使用自身的改进版本来重载var_dump()。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.profiler_append</td> 
 <td style="background:#F7F7F7;">integer类型，默认值=0</td> 
 <td style="background:#F7F7F7;">当多个请求映射到相同文件时，指定是覆盖之前的调试信息文件还是追加内容到该文件中。</td> 
 </tr> 
 <tr> 
 <td>xdebug.profiler_enable</td> 
 <td>integer类型，默认值=0</td> 
 <td>指定是否启用Xdebug的性能分析，并创建性能信息文件。</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.profiler_output_dir</td> 
 <td style="background:#F7F7F7;">string类型，默认值=/tmp</td> 
 <td style="background:#F7F7F7;">指定性能分析信息文件的输出目录</td> 
 </tr> 
 <tr> 
 <td>xdebug.profiler_output_name</td> 
 <td>string类型，默认值=cachegrind.out.%p</td> 
 <td>指定性能分析信息文件的名称</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.remote_enable</td> 
 <td style="background:#F7F7F7;">boolean类型，默认值=0</td> 
 <td style="background:#F7F7F7;">是否开启远程调试</td> 
 </tr> 
 <tr> 
 <td>xdebug.remote_handler</td> 
 <td>string类型，默认值=dbgp</td> 
 <td>指定远程调试的处理协议</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.remote_host</td> 
 <td style="background:#F7F7F7;">string类型，默认值=localhost</td> 
 <td style="background:#F7F7F7;">指定远程调试的主机名</td> 
 </tr> 
 <tr> 
 <td>xdebug.remote_log</td> 
 <td>string类型，默认值=</td> 
 <td>指定远程调试的日志文件名</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.remote_mode</td> 
 <td style="background:#F7F7F7;">string类型，默认值=req</td> 
 <td style="background:#F7F7F7;">可以设为req或jit，req表示脚本一开始运行就连接远程客户端，jit表示脚本出错时才连接远程客户端。</td> 
 </tr> 
 <tr> 
 <td>xdebug.remote_port</td> 
 <td>integer类型，默认值=9000</td> 
 <td>指定远程调试的端口号</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.trace_options</td> 
 <td style="background:#F7F7F7;">integer类型，默认值=0</td> 
 <td style="background:#F7F7F7;">指定对于之后的请求，追踪文件是追加内容还是覆盖之前内容。</td> 
 </tr> 
 <tr> 
 <td>xdebug.trace_output_dir</td> 
 <td>string类型，默认值=/tmp</td> 
 <td>指定追踪文件的存放目录</td> 
 </tr> 
 <tr> 
 <td style="background:#F7F7F7;">xdebug.trace_output_name</td> 
 <td style="background:#F7F7F7;">string类型，默认值=trace.%c</td> 
 <td style="background:#F7F7F7;">指定追踪文件的名称</td> 
 </tr> 
 </tbody> 
</table>

更多信息请参考[官方文档][Link 1]。

[Xdebug]: http://xdebug.org/download.php
[php_xdebug-2.2.5-5.5-vc11-nts-x86_64.dll]: https://xdebug.org/files/php_xdebug-2.2.5-5.5-vc11-nts-x86_64.dll
[view plain]: https://blog.csdn.net/l1028386804/article/details/51655507
[Link 1]: http://xdebug.org/docs/all_settings