Xdebug 参数配置

本文内容系从Xdebug官网总结翻译过来的，加上了一下自己的理解，本人水平有限，如果哪里有错欢迎果断指出！

 

一，安装Xdebug

       首先到http://xdebug.org/download.php 这个地址找一个符合你PHP版本的XDEBUG版本，我的PHP是5.2.11-NT，XP系统，所以使用的是http://xdebug.org/files/php_xdebug-2.1.1-5.2-vc6.dll，下载下来之后直接放到PHP的扩展目录，接下来就是配置了，在php.ini中加入一条 extension=php_xdebug.dll，然后restart web server。看看PHPINFO中是否有XDEBUG模块的信息，有的话，就搞定了。

             NOTE：安装都大同小异，但是配置的时候要注意点一点，不同版本的PHP有不同的配置方法

             1，如果是non-threaded版本的 加入一句   zend_extension="/wherever/you/put/it/xdebug.so"

             2，如果是threaded版本的PHP 则加入 zend_extension_ts="/wherever/you/put/it/xdebug.so"

             3，如果是5.3以上版本，统统使用  zend_extension="/wherever/you/put/it/xdebug.so"

  

二，配置Xdebug

 

xdebug.overload_var_dump

     类型：boolean  默认值：1

     xdebug默认会重载var_dump函数，它会按照他自己的格式来打印变量，如果你不想var_dump被充值，可以把overload_var_dump设置成0

xdebug.profiler_enable

     类型：boolean  默认值：0

     控制是否打开分析器，如果打开的话，会产生一些分析文件，文件放在xdebug.profiler_output_dir值所指的目录下，文件内记录了程序执行的一些信息。xdebug还提供另一种方式来开启这个功能，就是通过接下来会介绍到的xdebug.profiler_enable_trigger

xdebug.profiler_enable_trigger

     类型：boolean 默认值：0

     当这个值设置为1是，你只要通过GET/POST/COOKIE传递一个不为空的参数XDEBUG_PROFILE，那么xdebug就会记录程序的分析信息，如果没有这个参数，则不会产生分析日志。如果要让这个设置起作用，你最好把xdebug.profiler_enable设置成0

xdebug.profiler_output_dir

     类型：string 默认值：/tmp

     xdebug产生的分析信息存放的路径

xdebug.profiler_output_name

     类型：string 默认值：cachegrind.out.%p

     xdebug产生的程序分析日志的命名方式，其中可以使用的特殊字符为：

     - %c  crc32加密当前工作目录

     - %p  pid

     - %r  随机数

     - %s 执行脚本的文件名

     - %t  当前秒数

     - %u  当前秒数，区别于%t，这个带微秒数

     - %H  $_SERVER['HTTP_HOST']的值

     - %U  $_SERVER['UNIQUE_ID']

     - %S  session_id

     - %%  %号

xdebug.profiler_append

     类型：int  默认值：0

     如果该值=0，如果根据xdebug.profiler_output_name规则产生的profiler信息文件已经存在，则文件内容会被覆盖，如果该值!=0，则会被追加

xdebug.show_local_vars

     类型：int  默认值：0

     如果该值设置成不=0的任何值，那么当程序出错时，xdebug会打印出当前环境下的所有变量，注意，可能会产生大量垃圾信息，所以默认他是关闭的

xdebug.auto_trace

     类型：boolean  默认值：0

     是否记录PHP函数调用跟踪信息，如果设置为1，则xdebug会记录PHP程序的函数调用信息，并保存在xdebug.trace_output_dir目录中

xdebug.trace_output_dir

     类型：string  默认：/tmp

     保存PHP函数调用信息日志的目录

xdebug.trace_output_name

     类型：string  默认:trace.%c

     保存PHP函数调用信息日志文件的命名方式。使用方法类似与xdebug.profiler_output_name

xdebug.trace_enable_trigger

     类型：boolean  默认：0

     功能累死与xdebug.profiler_enable_trigger

xdebug.trace_format

     类型：int   默认：0

     该值控制trace信息的格式，有0，1，2三个值供选择，其中

     -  0 ：展示易读的trace信息，信息内容包括，开销时间，内存使用，memory delta信息（不知道是什么东西、、、），等级，函数名，函数参数（如果xdebug.collect_params功能是打开的），文件名以及行号

     - 1：产生计算机可识别的trace信息

     - 2：长生html形式的trace信息

xdebug.var_display_max_children,xdebug.var_display_max_data,xdebug.var_display_max_depth

     类型：int 默认：128，512，3

     这三个设置是控制xdebug_var_dump,被重载的var_dump，以及函数trace信息显示时的嵌套程度，包括展示的最大子元素，最大嵌套深度，以及最大信息量

xdebug.scream

     类型：boolean  默认：0

     如果该值=1，则php一直错误符@将失效

xdebug.collect_includes

     类型：boolean  默认：1

     该值控制是否在trace信息中记录被include(),require(),include_once(),require_once()包含的文件名

xdebug.collect_assignments

     类型:boolean  默认：0

     该值控制是否在trace信息中增加变量参数的信息

xdebug.collect_params

     类型：int  默认：0

    

xdebug.collect_return

     类型：boolean 默认：0

    

xdebug.collect_vars

     类型：boolean 默认：0

以上三个设置是配置trace信息中是否收集一下特殊信息，比如return是指函数返回结果，vars是值在一定范围内变量的信息，这个会产生很多的信息，会较大的影响PHP效率，留待以后研究

xdebug.trace_options

     类型：int  默认：0

     类似于xdebug.profiler_append