关于Xdebug配置

php相关 / 2011年07月27日 16时07分 / 9283人浏览
Xdebug配置 第一部分:基本特征: 相关参数设置 xdebug.default_enable 类型:布尔型 默认值:On 如果这项设置为On,堆栈跟踪将被默认的显示在错误事件中。你可以通过在代码中使用xdebug_disable()来禁止堆叠跟踪的显示。因为这是xdebug基本功能之一,将这项参数设置为On是比较明智的。 xdebug.max_nesting_level 类型:整型 默认值:100 The value of this setting is the maximum level of nested functions that are allowed before the script will be aborted. 限制无限递归的访问深度。这项参数设置的值是脚本失败前所允许的嵌套程序的最大访问深度。 第二部分:堆栈跟踪: 相关参数设置 xdebug.dump_globals 类型:布尔型 默认值:1 限制是否显示被xdebug.dump.*设置定义的超全局变量的值 例如,xdebug.dump.SERVER = REQUEST_METHOD,REQUEST_URI,HTTP_USER_AGENT 将打印 PHP 超全局变量 $_SERVER['REQUEST_METHOD']、$_SERVER['REQUEST_URI'] 和 $_SERVER['HTTP_USER_AGENT']。 xdebug.dump_once 类型:布尔型 默认值:1 限制是否超全局变量的值应该转储在所有出错环境(设置为Off时)或仅仅在开始的地方(设置为On时) xdebug.dump_undefined 类型:布尔型 默认值:0 如果你想从超全局变量中转储未定义的值,你应该把这个参数设置成On,否则就设置成Off xdebug.show_exception_trace 类型:整型 默认值:0 当这个参数被设置为1时,即使捕捉到异常,xdebug仍将强制执行异常跟踪当一个异常出现时。 xdebug.show_local_vars 类型:整型 默认值:0 当这个参数被设置为不等于0时,xdebug在错环境中所产生的堆栈转储还将显示所有局部变量,包括尚未初始化的变量在最上面。要注意的是这将产生大量的信息,也因此默认情况下是关闭的。 第三部分:分析PHP脚本 相关参数设置 xdebug.profiler_append 类型:整型 默认值:0 当这个参数被设置为1时,文件将不会被追加当一个新的需求到一个相同的文件时(依靠xdebug.profiler_output_name的设置)。相反的设置的话,文件将被附加成一个新文件。 xdebug.profiler_enable 类型:整型 默认值:0 开放xdebug文件的权限,就是在文件输出目录中创建文件。那些文件可以通过KCacheGrind来阅读来展现你的数据。这个设置不能通过在你的脚本中调用ini_set()来设置。 xdebug.profiler_output_dir 类型:字符串 默认值:/tmp 这个文件是profiler文件输出写入的,确信PHP用户对这个目录有写入的权限。这个设置不能通过在你的脚本中调用ini_set()来设置。 xdebug.profiler_output_name 类型:字符串 默认值:cachegrind.out%p 这个设置决定了转储跟踪写入的文件的名称。 第四部分:远程Debug 相关参数设置 xdebug.remote_autostart 类型:布尔型 默认值:0 一般来说,你需要使用明确的HTTP GET/POST变量来开启远程debug。而当这个参数设置为On,xdebug将经常试图去开启一个远程debug session并试图去连接客户端,即使GET/POST/COOKIE变量不是当前的。 xdebug.remote_enable 类型:布尔型 默认值:0 这个开关控制xdebug是否应该试着去连接一个按照xdebug.remote_host和xdebug.remote_port来设置监听主机和端口的debug客户端。 xdebug.remote_host 类型:字符串 默认值:localhost 选择debug客户端正在运行的主机,你不仅可以使用主机名还可以使用IP地址 xdebug.remote_port 类型:整型 默认值:9000 这个端口是xdebug试着去连接远程主机的。9000是一般客户端和被绑定的debug客户端默认的端口。许多客户端都使用这个端口数字,最好不要去修改这个设置。 注意:所有以上参数修改后,要重启Apache才能生效! Xdebug调试 其实PHP函数debug_backtrace()也有类似的功能,但是要注意debug_backtrace()函数只在PHP4.3.0之后版本及 PHP5中才生效。这个函数是PHP开发团队在PHP5中新增的函数,然后又反向移植到PHP4.3中。 Xdebug使调试信息更加美观 Xdebug扩展加载后,Xdebug会对原有的某些PHP函数进行覆写,以便好更好地进行Debug。比如var_dump()函数,我们知道通常我们 需要在函数前后加上”<pre>…</pre>”才能够让输出的变量信息比较美观、可读性好。但是加载了Xdebug后,我们不 再需要这样做了,Xdebug不但自动给我们加上了<pre>标签,还给变量加上颜色。 例: <?php $arrTest=array( "test"=>"abc", "test2"=>"abc2" ); var_dump($arrTest); ?> 输出: 看到了吗? 数组元素的值自动显示颜色。 如果你还是希望使用PHP的var_dump函数 只要在php.ini关于xdebug的配置中加上 xdebug.overload_var_dump = Off 即可 Xdebug测试脚本执行时间 测试某段脚本的执行时间,通常我们都需要用到microtime()函数来确定当前时间。例如PHP手册上的例子: <?php /** * Simple function to replicate PHP 5 behaviour */ function microtime_float() { list($usec, $sec) = explode(" ", microtime()); return ((float)$usec + (float)$sec); } $time_start = microtime_float(); // Sleep for a while usleep(100); $time_end = microtime_float(); $time = $time_end - $time_start; echo "Did nothing in $time seconds\n"; ?> 但是microtime()返回的值是微秒数及绝对时间戳(例如“0.03520000 1153122275”),没有可读性。所以如上程序,我们需要另外写一个函数microtime_float(),来将两者相加。 Xdebug自带了一个函数xdebug_time_index()来显示时间。 PHP脚本占用的内存 有时候我们想知道程序执行到某个特定阶段时到底占用了多大内存,为此PHP提供了函数memory_get_usage()。这个函数只有当PHP编译时使用了--enable-memory-limit参数时才有效。 Xdebug同样提供了一个函数xdebug_memory_usage()来实现这样的功能,另外xdebug还提供了一个xdebug_peak_memory_usage()函数来查看内存占用的峰值。 WinCacheGrind 有时候代码没有明显的编写错误,没有显示任何错误信息(如error、warning、notice等),但是这不表明代码就是正确无误的。有时候可能某 段代码执行时间过长,占用内存过多以致于影响整个系统的效率,我们没有办法直接看出来是哪部份代码出了问题。这时候我们希望把代码的每个阶段的运行情况都 监控起来,写到日志文件中去,运行一段时间后再进行分析,找到问题所在。 回忆一下,之前我们编辑php.ini文件 加入 [Xdebug] xdebug.profiler_enable=on xdebug.trace_output_dir="I:\Projects\xdebug" xdebug.profiler_output_dir="I:\Projects\xdebug" 这几行,目的就在于把执行情况的分析文件写入到”I:\Projects\xdebug”目录中去(你可以替换成任何你想设定的目录)。如果你执行某段程 序后,再打开相应的目录,可以发现生成了一堆文件,例如cachegrind.out.1169585776这种格式命名的文件。这些就是Xdebug生 成的分析文件。用编辑器打开你可以看到很多程序运行的相关细节信息,不过很显然这样看太累了,我们需要用图形化的软件来查看。 WinCacheGrind下载 在Windows平台下,可以用WinCacheGrind(wincachegrind.souceforge.net)这个软件来打开这些文件。可以直观漂亮地显示其中内容: WinCacheGrind小结: Xdebug提供了各种自带的函数,并对已有的某些PHP函数进行覆写,可以方便地用于调试排错;Xdebug还可以跟踪程序的运行,通过对日志文件的分析,我们可以迅速找到程序运行的瓶颈所在,提高程序效率,从而提高整个系统的性能。