Xdebug文档（三）堆栈跟踪

时间  2019-12-01
标签 xdebug 文档 堆栈 跟踪 栏目 Java 繁體版
原文   原文链接

当xdebug激活时，PHP一旦要显示通知、警告或错误时，xdebug 显示堆栈跟踪信息。这个堆栈信息能跟据你的须要来配置显示。php

Xdebug显示的堆栈跟踪都是以保守数量状态显示信息。由于大量的信息处理和呈现会拖慢脚本执行。经过不一样的设置对于显示更多详尽的信息提供了可能。html

 

堆栈跟踪的变量数组

Xdebug通常会在堆栈跟踪时显示变量信息。在收集和显示状况下变量信息都会携带大量资源。尽管如此，不少状况下这些变量信息的显示是颇有帮助的，这是为何会有xdebug.clollect_params设置的缘由。如下脚本，会在设置不一样值状况下输出不一样的信息：安全

The script

<?php
function foo( $a ) {
    for ($i = 1; $i < $a['foo']; $i++) {
        if ($i == 500000) xdebug_break();
    }
}

set_time_limit(1);
$c = new stdClass;
$c->bar = 100;
$a = array(
    42 => false, 'foo' => 912124,
    $c, new stdClass, fopen( '/etc/passwd', 'r' )
);
foo( $a );
?>

 

默认值：数据结构

( ! ) Fatal   error: Maximum execution time of 1 second exceeded in   /home/httpd/html/test/xdebug/docs/stack.php on line 34函数

Call Stack工具

#ui

Timethis

Memoryurl

Function

Location

1

0.0001

58564

{main}( )

../stack.php:0

2

0.0004

62764

foo( )

../stack.php:47

1值：

ini_set('xdebug.collect_params', '1');

( ! ) Fatal error: Maximum execution time of 1   second exceeded in /home/httpd/html/test/xdebug/docs/stack.php on line 31

Call   Stack

#

Time

Memory

Function

Location

1

0.0001

58132

{main}(   )

../stack.php:0

2

0.0004

62380

foo( array(5) )

../stack.php:47

2值：

ini_set('xdebug.collect_params', '2');

( ! ) Fatal error: Maximum execution time of 1   second exceeded in /home/httpd/html/test/xdebug/docs/stack.php on line 31

Call   Stack

#

Time

Memory

Function

Location

1

0.0001

58564

{main}(   )

../stack.php:0

2

0.0004

62812

foo( array(5) )

../stack.php:47

3值：

ini_set('xdebug.collect_params', '3');

( ! ) Fatal error: Maximum execution time of 1   second exceeded in /home/httpd/html/test/xdebug/docs/stack.php on line 31

Call   Stack

#

Time

Memory

Function

Location

1

0.0001

58564

{main}(   )

../stack.php:0

2

0.0004

62812

foo( array   (42 => FALSE, 'foo' => 912124, 43 => class stdClass { public $bar =   100 }, 44 => class stdClass { }, 45 => resource(2) of type   (stream)) )

../stack.php:47

 

4值：
ini_set('xdebug.collect_params', '4');

( ! ) Fatal error: Maximum execution time of 1   second exceeded in /home/httpd/html/test/xdebug/docs/stack.php on line 31

Call   Stack

#

Time

Memory

Function

Location

1

0.0001

58132

{main}(   )

../stack.php:0

2

0.0004

62380

foo( $a   = array (42 => FALSE, 'foo' => 912124, 43 => class stdClass {   public $bar = 100 }, 44 => class stdClass { }, 45 => resource(2) of   type (stream)) )

../stack.php:47

 

相关设置：

xdebug.cli_color

类型: integer, 默认值: 0, 始于 2.2版以上

设置为1时，xdebug会在CLI模式下且在tty终端输出时，会以有色显示var_dump跟踪输出的文字。window下, ANSICON工具须要安装。

设置为2时，则不论是否链接到tty终端或ANSICON是否被安装，xdebug会一直用颜色显示var_dump和调试跟踪信息。这种情形下，你可能在结束处看到转义码。

 

xdebug.collect_includes

类型: boolean, 默认值: 1

默认状况下xdebug将使用include(), include_once(), require() 或 require_once()方法引用的文件名写入到跟踪文件里。

 

xdebug.collect_params

类型: integer, 默认值: 0

默认为0时，该设置控制xdebug不论是函数追踪仍是堆栈跟踪都会收集调用函数的参数。

默认0值是考虑到大规模脚本会占用大量内存，因此不会为了大脚原本运行它。你能够安全地打开此设置，但你会预料到会一些脚本上的问题像大量函数调用兼庞大的数据结构做为参数传递。Xdebug2不会有增长内存使用的问题，由于它不会存储到内存，而是只存入磁盘中。这只须要你有足够的磁盘使用量便可。

该设置有4种设置值。每种都会呈现不一样的信息。如下表格展现各类设置值信息：

Value

Argument   Information Shown

0

无.

1

展现变量元素的值类型和值。

2

展现变量元素的值类型和值，并附带滑鼠提示显示完整信息。（CLI模式下不存在滑鼠提示）

3

完整变量内容（内容受限于如下设置： xdebug.var_display_max_children,xdebug.var_display_max_data and xdebug.var_display_max_depth.）

4

完整变量内容和名称。

5

PHP 序列化变量内容，不含名称。(2.3版本新特性)

 

xdebug.collect_vars

类型: boolean, 默认值: 0

该设置会让xdebug在必定范围内去收集变量信息。而这种分析工做至关慢由于xdebug会逆向解析PHP代码。该设置不会记录不一样变量的值。若是你要利用xdebug_get_declared_vars()函数，那么就须要开启该设置了。

 

xdebug.dump.*

类型: string, 默认值: Empty

* 号能够用 COOKIE, FILES, GET, POST, REQUEST, SERVER, SESSION任意一个来代替. 这七个设置值控制在错误发生时的超全局变量的数据。

在php.ini中每一个设置值都由逗号分隔造成变量列表，或者*号表明所有。要肯定你在设置里没有空格。

为了在错误发生时收到REMOTE_ADDR 和 REQUEST_METHOD 信息和全部GET参数，能够设置：

xdebug.dump.SERVER = REMOTE_ADDR,REQUEST_METHOD

xdebug.dump.GET = *

 

xdebug.dump_globals

类型: boolean, 默认: 1

控制超全局变量值是否显示，不管在xdebug.dump.*设置了什么。

 

xdebug.dump_once

类型: boolean, 默认值: 1

控制是否在全部错误状况下显示超全局变量值（设为0值）或只在第一次出现（设为1值）。

 

xdebug.dump_undefined

类型: boolean, 默认值: 0

若是须要显示超全局变量中未定义值则该项设为1，不然保留0默认项。

 

xdebug.manual_url

类型: string, 默认值: http://www.php.net, 始于 Xdebug 2.2.1如下版本

指定函数追踪和错误信息的连接说明来源。建议设定使用最近的镜像连接。

 

xdebug.show_exception_trace

类型: integer, 默认值: 0

当设置为1时，Xdebug会在异常出现时甚至是该异常被捕捉也会显示其堆栈跟踪信息。

 

xdebug.show_local_vars

类型: integer, 默认值: 0

当设置为非0值时，Xdebug在错误状况下产生的堆栈跟踪会显示全部变量信息在最顶端范围。这有可能会产生大量信息，因此默认状况下关闭。

 

xdebug.show_mem_delta

Type: integer, Default value: 0

当该设置不为0时，xdebug的人类可读性追踪记录文件会显示函数调用时内存使用量。若是xdebug配值为产生机器可读性追踪文件，那么它们常常显示这些信息。、

 

xdebug.var_display_max_children

类型: integer, 默认值: 128

在使用 xdebug_var_dump()，xdebug.show_local_vars 或 追踪函数时，该设置控制数组元素和对象属性的数量显示。

若不受限制，能够设为-1值。

该设置不受Remot_Debuggin远程调试的任何影响。

 

xdebug.var_display_max_data

类型: integer, 默认值: 512

在使用 xdebug_var_dump()，xdebug.show_local_vars 或 追踪函数时，该设置控制字符串长度显示最大值。

若不受限制，能够设为-1值。

该设置不受Remot_Debugging远程调试的任何影响。

 

xdebug.var_display_max_depth

类型: integer, 默认值: 3

在使用 xdebug_var_dump()，xdebug.show_local_vars 或 追踪函数时，该设置控制数组元素和对象属性的显示层级。

最大值为1023，你能够设为-1表示其最大值。

该设置不受Remot_Debugging远程调试的任何影响。

 

相关函数：

array xdebug_get_declared_vars()

返回一个数组，数组元素都是当前范围内已定义的变量名。要使函数生效则xdebug.collect_vars必须开启。

Example:

<?php
    class strings {
        static function fix_strings($a, $b) {
            foreach ($b as $item) {
            }
            var_dump(xdebug_get_declared_vars());
        }
    }
    strings::fix_strings(array(1,2,3), array(4,5,6));
?>
/**
Returns:
array
  0 => string 'a' (length=1)
  1 => string 'b' (length=1)
  2 => string 'item' (length=4)
 
*/

 

PHP5.1以前版本，变量名“a”不会在返回的数组中，由于在xdebug_get_declared_vars()函数执行时，该变量没被使用。

 

array xdebug_get_function_stack()

返回一数组，内含在函数这个点显示出来的相似于堆栈跟踪的信息。

Example:

<?php
    class strings {
        function fix_string($a)
        {
            var_dump(xdebug_get_function_stack());
        }

        function fix_strings($b) {
            foreach ($b as $item) {
                $this->fix_string($item);
            }
        }
    }

    $s = new strings();
    $ret = $s->fix_strings(array('Derick'));
?>
/**
Returns:

array

  0 => 

    array

      'function' => string '{main}' (length=6)

      'file' => string '/var/www/xdebug_get_function_stack.php' (length=63)

      'line' => int 0

      'params' => 

        array

          empty

  1 => 

    array

      'function' => string 'fix_strings' (length=11)

      'class' => string 'strings' (length=7)

      'file' => string '/var/www/xdebug_get_function_stack.php' (length=63)

      'line' => int 18

      'params' => 

        array

          'b' => string 'array (0 => 'Derick')' (length=21)

  2 => 

    array

      'function' => string 'fix_string' (length=10)

      'class' => string 'strings' (length=7)

      'file' => string '/var/www/xdebug_get_function_stack.php' (length=63)

      'line' => int 12

      'params' => 

        array

          'a' => string ''Derick'' (length=8)

 */

 

 

integer xdebug_get_stack_depth()

返回堆栈深度层级。脚本主体为0级而各类引用或调用函数则添加一个堆栈深度层级。

 

none xdebug_print_function_stack( [ string message [, int options ] ] )

用相似在错误状况下显示当前函数追踪信息。

"message" 参数容许你能够自定义显示信息。 (始于Xdebug 2.1版本).

Example:

<?php
function foo( $far, $out )
{
    xdebug_print_function_stack( 'Your own message' );
}
foo( 42, 3141592654 );
?>

 

Returns:

( ! ) Xdebug: Your own message in   /home/httpd/html/test/xdebug/print_function_stack.php on line 5

Call Stack

#

Time

Memory

Function

Location

1

0.0006

653896

{main}( )

../print_function_stack.php:0

2

0.0007

654616

foo( 42, 3141592654 )

../print_function_stack.php:7

3

0.0007

654736

xdebug_print_function_stack ( 'Your own message' )

../print_function_stack.php:5

 
 
 

掩码参数"options" 容许你配置一些额外的参数选项。支持的选项有：

XDEBUG_STACK_NO_DESC

若是设置此项，则显示的追踪信息不包含头部。这对于你想从自定义的错误处理器中显示本身的错误追踪信息就颇有用。除此以外，你能够在须要显示的位置调用xdebug_print_function_statck()函数。（始于xdebug2.3）

void xdebug_start_function_monitor( array $list_of_functions_to_monitor )

开始函数监控。

始于版本2.4

该函数在将一系列的函数名做为参数传递时就开始监视这些函数。函数监视器会找出这些你提供的函数所在的代码。这样能够用于追踪那些旧函数或废弃的函数。

Example:

<?php
xdebug_start_function_monitor( [ 'strrev', 'array_push' ] );
?>

 

你也能够添加类方法或静态方法到数组中进行监视。例如，为了捕获静态调用DramModel::canSee 和 动态调用 Whisky->drink，你能够开始如下监视:

Example:

<?php
xdebug_start_function_monitor( [ 'DramModel::canSee', 'Whisky->drink'] );
?>

 

被定义的函数要区分大小写，若动态调用到静态方法将不会被捕获。

 

void xdebug_stop_function_monitor()

中止函数监视

始于版本2.4

该函数中止对函数监视。须要获取被监视函数列表，可使用xdebug_get_monitored_functions()函数。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程