内容简介:Xdebug中文文档-变量打印特性
文档内容来自 xdebug.org/docs
,翻译时xdebug版本为 2.6
。我在官方文档基础上针对中文排版和教程内容的编排做了一些优化,希望中文文档看起来更容易理解。
英文原始文档地址: https://xdebug.org/docs/
中文文档github地址: https://github.com/Anoxia/xde...
Xdebug替换了 PHP 的 var_dump()
函数来显示变量。Xdebug的版本包含不同类型的不同颜色,并限制数组元素/对象属性的数量,最大深度和字符串长度。还有一些其他功能处理变量显示。
设置对var_dump的影响
有许多设置可以控制Xdebug修改的var_dump()函数的输出 :xdebug.var_display_max_children,xdebug.var_display_max_data和xdebug.var_display_max_depth。这三个设置的效果最好用一个例子来展示。下面的脚本运行四次,每次都有不同的设置。您可以使用这些标签来查看差异。
代码:
<?php class test { public $pub = false; private $priv = true; protected $prot = 42; } $t = new test; $t->pub = $t; $data = array( 'one' => 'a somewhat long string!', 'two' => array( 'two.one' => array( 'two.one.zero' => 210, 'two.one.one' => array( 'two.one.one.zero' => 3.141592564, 'two.one.one.one' => 2.7, ), ), ), 'three' => $t, 'four' => range(0, 5), ); var_dump( $data ); ?>
输出(默认值):
array 'one' => string 'a somewhat long string!' (length=23) 'two' => array 'two.one' => array 'two.one.zero' => int 210 'two.one.one' => array ... 'three' => object(test)[1] public 'pub' => &object(test)[1] private 'priv' => boolean true protected 'prot' => int 42 'four' => array 0 => int 0 1 => int 1 2 => int 2 3 => int 3 4 => int 4 5 => int 5
输出(xdebug.var_display_max_children = 2):
array 'one' => string 'a somewhat long string!' (length=23) 'two' => array 'two.one' => array 'two.one.zero' => int 210 'two.one.one' => array ... more elements...
输出(xdebug.var_display_max_data = 16):
array 'one' => string 'a somewhat long '... (length=23) 'two' => array 'two.one' => array 'two.one.zero' => int 210 'two.one.one' => array ... 'three' => object(test)[1] public 'pub' => &object(test)[1] private 'priv' => boolean true protected 'prot' => int 42 'four' => array 0 => int 0 1 => int 1 2 => int 2 3 => int 3 4 => int 4 5 => int 5
输出(xdebug.var_display_max_depth = 2):
array 'one' => string 'a somewhat long string!' (length=23) 'two' => array 'two.one' => array ... 'three' => object(test)[1] public 'pub' => &object(test)[1] private 'priv' => boolean true protected 'prot' => int 42 'four' => array 0 => int 0 1 => int 1 2 => int 2 3 => int 3 4 => int 4 5 => int 5
输出(xdebug.var_display_max_children = 3,xdebug.var_display_max_data = 8,xdebug.var_display_max_depth = 1):
array 'one' => string 'a somewh'... (length=23) 'two' => array ... 'three' => object(test)[1] ... more elements...
相关设置
xdebug.cli_color
该功能仅适用于 Xdebug> = 2.2
类型:整数,默认值:0,
如果此设置为1,则在CLI模式下以及输出为tty时,var_dumps和堆栈跟踪Xdebug将着色输出。在Windows上, 需要安装 ANSICON 工具。
如果设置为2,那么无论是否连接到tty或是否安装ANSICON,Xdebug将始终为var_dumps和堆栈跟踪着色。在这种情况下,您最终可能会看到转义码。
看到 这篇文章 的一些更多的信息。
xdebug.overload_var_dump
该功能仅适用于 Xdebug> = 2.1
当 php.ini
中html_errors设置为1或2时,Xdebug会默认更改var_dump输出。如果您不希望如此,您可以将其值设置为0,但是首先检查是否智能关闭html_errors。
该值设置为2时,除了很好的格式化var_dump()输出外,它还会将文件名和行号添加到输出中。
在Xdebug 2.4之前,这个设置的默认值是 1
。
xdebug.var_display_max_children
类型:整数,默认值:128
当使用xdebug_var_dump(), xdebug.show_local_vars或通过函数轨迹显示变量时,控制数组的数量和子对象的属性。
要禁用任何限制,请使用-1作为值。
此设置对通过远程调试功能发送给客户端的子项数量没有任何影响。
xdebug.var_display_max_data
类型:整数,默认值:512
控制使用xdebug_var_dump(), xdebug.show_local_vars或通过函数轨迹显示变量时显示的最大字符串长度。
要禁用任何限制,请使用-1作为值。
此设置对通过远程调试功能发送给客户端的子项数量没有任何影响。
xdebug.var_display_max_depth
通过xdebug_var_dump(), xdebug.show_local_vars或函数轨迹显示变量时,控制数组元素和对象属性的嵌套级别。
您可以选择的最大值是1023。您也可以使用-1作为值来选择此最大值。
此设置对通过远程调试功能发送给客户端的子项数量没有任何影响。
相关函数
void var_dump( [mixed var [, ...]] )
显示有关变量的详细信息
这个函数被Xdebug重载,参见xdebug_var_dump()的描述 。
void xdebug_debug_zval( [string varname [, ...]] )
显示有关变量的信息
此功能显示有关一个或多个变量的结构化信息,其中包括其类型,值和引用计数信息。数组通过值递归地进行探索。这个函数的实现方式与PHP的debug_zval_dump()函数不同,是用来解决debug_zval_dump()函数存在的问题,因为变量本身实际上被传递给函数。Xdebug的版本更好,因为它使用变量名查找内部符号表中的变量,并直接访问所有属性,而不必处理实际将变量传递给函数。结果是这个函数返回的信息比PHP自己的显示zval信息的函数要准确得多。
自Xdebug 2.3以来, 支持除简单变量名称(如下面的“a [2]”)之外的任何其他内容。
例:
<?php $a = array(1, 2, 3); $b =& $a; $c =& $a[2]; xdebug_debug_zval('a'); xdebug_debug_zval("a[2]"); ?>
输出:
a: (refcount=2, is_ref=1)=array ( 0 => (refcount=1, is_ref=0)=1, 1 => (refcount=1, is_ref=0)=2, 2 => (refcount=2, is_ref=1)=3) a[2]: (refcount=2, is_ref=1)=3
void xdebug_debug_zval_stdout( [string varname [, ...]] )
将有关变量的信息返回到stdout。
此功能显示有关一个或多个变量的结构化信息,其中包括其类型,值和引用计数信息。数组通过值递归地进行探索。与xdebug_debug_zval()的不同之处在于信息不是通过Web服务器API层显示的,而是直接显示在标准输出上(所以当你在单进程模式下运行Apache时,它将在控制台上输出)。
例:
<?php $a = array(1, 2, 3); $b =& $a; $c =& $a[2]; xdebug_debug_zval_stdout('a');
输出:
a: (refcount=2, is_ref=1)=array ( 0 => (refcount=1, is_ref=0)=1, 1 => (refcount=1, is_ref=0)=2, 2 => (refcount=2, is_ref=1)=3)
void xdebug_dump_superglobals()
显示有关超级全局的信息
这个函数按照 xdebug.dump.*
在php.ini的设置转储超级全局元素的值。对于下面的例子,php.ini中的设置是:
xdebug.dump.GET=* xdebug.dump.SERVER=REMOTE_ADDR Query string: ?var=fourty%20two&array[a]=a&array[9]=b
返回:
Dump $_SERVER | |
---|---|
$_SERVER['REMOTE_ADDR'] =
|
string '127.0.0.1' *(length=9)*
|
Dump $_GET | |
---|---|
$_GET['var'] =
|
string 'fourty two' *(length=10)*
|
$_GET['array'] =
|
**array** 'a' => string 'a' *(length=1)* 9 => string 'b' *(length=1)*
|
void xdebug_var_dump( [mixed var [, ...]] )
显示有关变量的详细信息
此功能显示关于一个或多个表达式的结构化信息,包括其类型和值。数组通过值递归地进行探索。请参阅php.ini设置影响此功能的变量显示功能的介绍(上文)。
例:
<?php ini_set('xdebug.var_display_max_children', 3 ); $c = new stdClass; $c->foo = 'bar'; $c->file = fopen( '/etc/passwd', 'r' ); var_dump( array( array(TRUE, 2, 3.14, 'foo'), 'object' => $c ) ); ?>
输出:
array 0 => array 0 => boolean true 1 => int 2 2 => float 3.14 more elements... 'object' => object(stdClass)[1] public 'foo' => string 'bar' (length=3) public 'file' => resource(3, stream)
以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网
猜你喜欢:- CSS var变量的局部作用域特性
- 全局变量,静态全局变量,局部变量,静态局部变量
- python变量与变量作用域
- Python基础-类变量和实例变量
- python编程(类变量和实例变量)
- 03-Golang局部变量和全局变量
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
A=B
Marko Petkovsek、Herbert S. Wilf、Doron Zeilberger / AK Peters, Ltd. / 1996-01 / USD 49.00
At some point, this book describes methods of solving the problem raised by Donald E. Knuth in the classical book "The Art of Computer Programming, Volume 1: Fundamental Algorithms". The main purpo......一起来看看 《A=B》 这本书的介绍吧!