var_dump

(PHP 4, PHP 5, PHP 7, PHP 8)

var_dump — 转储有关变量的信息

描述

var_dump(混合 $value, 混合 ...$values): 空

此函数显示一个或多个表达式的结构化信息，包括其类型和值。数组和对象以递归方式展开，并使用缩进显示结构。

除非对象实现了 __debugInfo() 方法，否则将返回对象的全部公有、私有和受保护属性。

提示

与任何直接输出结果到浏览器的操作一样，输出控制函数可用于捕获此函数的输出，并将其保存到字符串（例如）中。

参数

value: 要转储的表达式。
values: 要转储的其他表达式。

返回值

不返回值。

示例

示例 #1 var_dump() 示例

<?php
$a = array(1, 2, array("a", "b", "c"));
var_dump($a);
?>

以上示例将输出

array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  array(3) {
    [0]=>
    string(1) "a"
    [1]=>
    string(1) "b"
    [2]=>
    string(1) "c"
  }
}

<?php

$b = 3.1;
$c = true;
var_dump($b, $c);

?>

以上示例将输出

float(3.1)
bool(true)

参见

print_r() - 打印变量的人类可读信息
debug_zval_dump() - 将内部 zval 结构的字符串表示形式转储到输出
var_export() - 输出或返回变量的可解析字符串表示形式
__debugInfo()

发现问题？

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 16 个注释

踩

153

rich dot schu at gmail dot com ¶

16 年前

请记住，如果您安装了 xdebug，它会将数组元素和对象属性的 var_dump() 输出限制为 3 层深度。

要更改默认值，请编辑您的 xdebug.ini 文件并添加以下行
xdebug.var_display_max_depth=n

更多信息请参见此处
http://www.xdebug.org/docs/display

踩

133

edwardzyang at thewritingpot dot com ¶

19 年前

如果您像我一样，在调试时总是使用 var_dump，您可能会发现以下两个“包装器”函数很有用。

此函数会在 var_dump 输出周围自动添加 PRE 标签，以便您获得格式良好的数组。

<?php

function var_dump_pre($mixed = null) {
 echo '<pre>';
 var_dump($mixed);
 echo '</pre>';
 return null;
}

?>

此函数返回 var_dump 的值，而不是输出它。

<?php

function var_dump_ret($mixed = null) {
 ob_start();
 var_dump($mixed);
 $content = ob_get_contents();
 ob_end_clean();
 return $content;
}

?>

非常简单的函数，但它们非常有用（我现在几乎只使用 var_dump_pre()）。

踩

b dot bergloev at gmail dot com ¶

10 年前

我发布了一个新的 var_dump 函数，它具有颜色和折叠功能。如果从终端执行它，它也可以适应终端输出。无需将其包装在 pre 标签中即可在浏览器中工作。

<?php
function dump_debug($input, $collapse=false) {
 $recursive = function($data, $level=0) use (&$recursive, $collapse) {
 global $argv;

 $isTerminal = isset($argv);

 if (!$isTerminal && $level == 0 && !defined("DUMP_DEBUG_SCRIPT")) {
 define("DUMP_DEBUG_SCRIPT", true);

 echo '<script language="Javascript">function toggleDisplay(id) {';
 echo 'var state = document.getElementById("container"+id).style.display;';
 echo 'document.getElementById("container"+id).style.display = state == "inline" ? "none" : "inline";';
 echo 'document.getElementById("plus"+id).style.display = state == "inline" ? "inline" : "none";';
 echo '}</script>'."\n";
 }

 $type = !is_string($data) && is_callable($data) ? "Callable" : ucfirst(gettype($data));
 $type_data = null;
 $type_color = null;
 $type_length = null;

 switch ($type) {
 case "String": 
 $type_color = "green";
 $type_length = strlen($data);
 $type_data = "\"" . htmlentities($data) . "\""; break;

 case "Double": 
 case "Float": 
 $type = "Float";
 $type_color = "#0099c5";
 $type_length = strlen($data);
 $type_data = htmlentities($data); break;

 case "Integer": 
 $type_color = "red";
 $type_length = strlen($data);
 $type_data = htmlentities($data); break;

 case "Boolean": 
 $type_color = "#92008d";
 $type_length = strlen($data);
 $type_data = $data ? "TRUE" : "FALSE"; break;

 case "NULL": 
 $type_length = 0; break;

 case "Array": 
 $type_length = count($data);
 }

 if (in_array($type, array("Object", "Array"))) {
 $notEmpty = false;

 foreach($data as $key => $value) {
 if (!$notEmpty) {
 $notEmpty = true;

 if ($isTerminal) {
 echo $type . ($type_length !== null ? "(" . $type_length . ")" : "")."\n";

 } else {
 $id = substr(md5(rand().":".$key.":".$level), 0, 8);

 echo "<a href=\"javascript:toggleDisplay('". $id ."');\" style=\"text-decoration:none\">";
 echo "<span style='color:#666666'>" . $type . ($type_length !== null ? "(" . $type_length . ")" : "") . "</span>";
 echo "</a>";
 echo "<span id=\"plus". $id ."\" style=\"display: " . ($collapse ? "inline" : "none") . ";\">&nbsp;&#10549;</span>";
 echo "<div id=\"container". $id ."\" style=\"display: " . ($collapse ? "" : "inline") . ";\">";
 echo "<br />";
 }

 for ($i=0; $i <= $level; $i++) {
 echo $isTerminal ? "| " : "<span style='color:black'>|</span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;";
 }

 echo $isTerminal ? "\n" : "<br />";
 }

 for ($i=0; $i <= $level; $i++) {
 echo $isTerminal ? "| " : "<span style='color:black'>|</span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;";
 }

 echo $isTerminal ? "[" . $key . "] => " : "<span style='color:black'>[" . $key . "]&nbsp;=>&nbsp;</span>";

 call_user_func($recursive, $value, $level+1);
 }

 if ($notEmpty) {
 for ($i=0; $i <= $level; $i++) {
 echo $isTerminal ? "| " : "<span style='color:black'>|</span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;";
 }

 if (!$isTerminal) {
 echo "</div>";
 }

 } else {
 echo $isTerminal ? 
 $type . ($type_length !== null ? "(" . $type_length . ")" : "") . " " : 
 "<span style='color:#666666'>" . $type . ($type_length !== null ? "(" . $type_length . ")" : "") . "</span>&nbsp;&nbsp;";
 }

 } else {
 echo $isTerminal ? 
 $type . ($type_length !== null ? "(" . $type_length . ")" : "") . " " : 
 "<span style='color:#666666'>" . $type . ($type_length !== null ? "(" . $type_length . ")" : "") . "</span>&nbsp;&nbsp;";

 if ($type_data != null) {
 echo $isTerminal ? $type_data : "<span style='color:" . $type_color . "'>" . $type_data . "</span>";
 }
 }

 echo $isTerminal ? "\n" : "<br />";
 };

 call_user_func($recursive, $input);
}
?>

踩

匿名 ¶

19 年前

var_dump(get_defined_vars());
将所有已定义的变量转储到浏览器。

踩

stlawson *AT* joyfulearthtech *DOT* com ¶

13 年前

<?php
/**
 * 比 print_r 或 var_dump 更好的输出变量信息 -- 但与 var_dump 不同，你只能输出一个变量。 
 * 在 echo 输出变量内容之前添加了 htmlentities 函数，这样你就能看到变量的真实内容，而不是标记。 
 * 
 * 此外，输出现在被包含在一个 div 块中，该块设置了背景颜色、字体样式，并使其左对齐，
 * 因此它不受周围样式的影响。 
 *
 * 灵感来自：PHP.net 贡献 
 * 摘自： [highstrike at gmail dot com] 
 * 由以下人员修改： stlawson *AT* JoyfulEarthTech *DOT* com 
 *
 * @param mixed $var -- 要输出的变量 
 * @param string $var_name -- 变量名称（可选）-- 在打印输出中显示，方便在复杂的输出中区分哪个变量是哪个 
 * @param string $indent -- 由内部递归调用使用（没有已知的外部值） 
 * @param unknown_type $reference -- 由内部递归调用使用（没有已知的外部值） 
 */
function do_dump(&$var, $var_name = NULL, $indent = NULL, $reference = NULL)
{
 $do_dump_indent = "<span style='color:#666666;'>|</span> &nbsp;&nbsp; ";
 $reference = $reference.$var_name;
 $keyvar = 'the_do_dump_recursion_protection_scheme'; $keyname = 'referenced_object_name';
 
 // 使其始终可见、始终左对齐且可读
 echo "<div style='text-align:left; background-color:white; font: 100% monospace; color:black;'>";

 if (is_array($var) && isset($var[$keyvar]))
 {
 $real_var = &$var[$keyvar];
 $real_name = &$var[$keyname];
 $type = ucfirst(gettype($real_var));
 echo "$indent$var_name <span style='color:#666666'>$type</span> = <span style='color:#e87800;'>&amp;$real_name</span><br>";
 }
 else
 {
 $var = array($keyvar => $var, $keyname => $reference);
 $avar = &$var[$keyvar];

 $type = ucfirst(gettype($avar));
 if($type == "String") $type_color = "<span style='color:green'>";
 elseif($type == "Integer") $type_color = "<span style='color:red'>";
 elseif($type == "Double"){ $type_color = "<span style='color:#0099c5'>"; $type = "Float"; }
 elseif($type == "Boolean") $type_color = "<span style='color:#92008d'>";
 elseif($type == "NULL") $type_color = "<span style='color:black'>";

 if(is_array($avar))
 {
 $count = count($avar);
 echo "$indent" . ($var_name ? "$var_name => ":"") . "<span style='color:#666666'>$type ($count)</span><br>$indent(<br>";
 $keys = array_keys($avar);
 foreach($keys as $name)
 {
 $value = &$avar[$name];
 do_dump($value, "['$name']", $indent.$do_dump_indent, $reference);
 }
 echo "$indent)<br>";
 }
 elseif(is_object($avar))
 {
 echo "$indent$var_name <span style='color:#666666'>$type</span><br>$indent(<br>";
 foreach($avar as $name=>$value) do_dump($value, "$name", $indent.$do_dump_indent, $reference);
 echo "$indent)<br>";
 }
 elseif(is_int($avar)) echo "$indent$var_name = <span style='color:#666666'>$type(".strlen($avar).")</span> $type_color".htmlentities($avar)."</span><br>";
 elseif(is_string($avar)) echo "$indent$var_name = <span style='color:#666666'>$type(".strlen($avar).")</span> $type_color\"".htmlentities($avar)."\"</span><br>";
 elseif(is_float($avar)) echo "$indent$var_name = <span style='color:#666666'>$type(".strlen($avar).")</span> $type_color".htmlentities($avar)."</span><br>";
 elseif(is_bool($avar)) echo "$indent$var_name = <span style='color:#666666'>$type(".strlen($avar).")</span> $type_color".($avar == 1 ? "TRUE":"FALSE")."</span><br>";
 elseif(is_null($avar)) echo "$indent$var_name = <span style='color:#666666'>$type(".strlen($avar).")</span> {$type_color}NULL</span><br>";
 else echo "$indent$var_name = <span style='color:#666666'>$type(".strlen($avar).")</span> ".htmlentities($avar)."<br>";

 $var = $var[$keyvar];
 }
 
 echo "</div>";
}
?>

踩

thriller dot ze at gmail dot com ¶

17 年前

正如 Bryan 所说，可以捕获 var_dump() 的输出到一个字符串中。但是，如果转储的变量包含 HTML 代码，则不会完全准确。

您可以改用此方法

<?php
echo '<pre>'; // 这是为了正确处理换行符
ob_start();
var_dump($var);
$a=ob_get_contents();
ob_end_clean();
echo htmlspecialchars($a,ENT_QUOTES); // 转义所有 HTML 特殊字符（尤其是 > 和 < ）
echo '</pre>';
?>

踩

egorinsk at gmail com ¶

15 年前

请注意，var_dump 会重置数组的内部指针！

踩

highstrike at gmail dot com ¶

16 年前

基于一些人在这里的贡献，我创建了两个简洁的功能。希望您觉得它们有用。

用法……调用 dump 函数。例如：dump($array, "Array dump");

<?php
////////////////////////////////////////////////////////
// 函数: dump
// 灵感来源: PHP.net 贡献
// 描述: 帮助进行 php 调试

function dump(&$var, $info = FALSE)
{
 $scope = false;
 $prefix = 'unique';
 $suffix = 'value';
 
 if($scope) $vals = $scope;
 else $vals = $GLOBALS;

 $old = $var;
 $var = $new = $prefix.rand().$suffix; $vname = FALSE;
 foreach($vals as $key => $val) if($val === $new) $vname = $key;
 $var = $old;

 echo "<pre style='margin: 0px 0px 10px 0px; display: block; background: white; color: black; font-family: Verdana; border: 1px solid #cccccc; padding: 5px; font-size: 10px; line-height: 13px;'>";
 if($info != FALSE) echo "<b style='color: red;'>$info:</b><br>";
 do_dump($var, '$'.$vname);
 echo "</pre>";
}

////////////////////////////////////////////////////////
// 函数: do_dump
// 灵感来源: PHP.net 贡献
// 描述: 比 print_r 或 var_dump 更好的输出

function do_dump(&$var, $var_name = NULL, $indent = NULL, $reference = NULL)
{
 $do_dump_indent = "<span style='color:#eeeeee;'>|</span> &nbsp;&nbsp; ";
 $reference = $reference.$var_name;
 $keyvar = 'the_do_dump_recursion_protection_scheme'; $keyname = 'referenced_object_name';

 if (is_array($var) && isset($var[$keyvar]))
 {
 $real_var = &$var[$keyvar];
 $real_name = &$var[$keyname];
 $type = ucfirst(gettype($real_var));
 echo "$indent$var_name <span style='color:#a2a2a2'>$type</span> = <span style='color:#e87800;'>&amp;$real_name</span><br>";
 }
 else
 {
 $var = array($keyvar => $var, $keyname => $reference);
 $avar = &$var[$keyvar];
 
 $type = ucfirst(gettype($avar));
 if($type == "String") $type_color = "<span style='color:green'>";
 elseif($type == "Integer") $type_color = "<span style='color:red'>";
 elseif($type == "Double"){ $type_color = "<span style='color:#0099c5'>"; $type = "Float"; }
 elseif($type == "Boolean") $type_color = "<span style='color:#92008d'>";
 elseif($type == "NULL") $type_color = "<span style='color:black'>";
 
 if(is_array($avar))
 {
 $count = count($avar);
 echo "$indent" . ($var_name ? "$var_name => ":"") . "<span style='color:#a2a2a2'>$type ($count)</span><br>$indent(<br>";
 $keys = array_keys($avar);
 foreach($keys as $name)
 {
 $value = &$avar[$name];
 do_dump($value, "['$name']", $indent.$do_dump_indent, $reference);
 }
 echo "$indent)<br>";
 }
 elseif(is_object($avar))
 {
 echo "$indent$var_name <span style='color:#a2a2a2'>$type</span><br>$indent(<br>";
 foreach($avar as $name=>$value) do_dump($value, "$name", $indent.$do_dump_indent, $reference);
 echo "$indent)<br>";
 }
 elseif(is_int($avar)) echo "$indent$var_name = <span style='color:#a2a2a2'>$type(".strlen($avar).")</span> $type_color$avar</span><br>";
 elseif(is_string($avar)) echo "$indent$var_name = <span style='color:#a2a2a2'>$type(".strlen($avar).")</span> $type_color\"$avar\"</span><br>";
 elseif(is_float($avar)) echo "$indent$var_name = <span style='color:#a2a2a2'>$type(".strlen($avar).")</span> $type_color$avar</span><br>";
 elseif(is_bool($avar)) echo "$indent$var_name = <span style='color:#a2a2a2'>$type(".strlen($avar).")</span> $type_color".($avar == 1 ? "TRUE":"FALSE")."</span><br>";
 elseif(is_null($avar)) echo "$indent$var_name = <span style='color:#a2a2a2'>$type(".strlen($avar).")</span> {$type_color}NULL</span><br>";
 else echo "$indent$var_name = <span style='color:#a2a2a2'>$type(".strlen($avar).")</span> $avar<br>";

 $var = $var[$keyvar];
 }
}
?>

踩

匿名用户 ¶

8 年前

小心，这会输出到标准输出流 (1) 而不是正确的标准错误流 (2)。

踩

php at mikeboers dot com ¶

17 年前

您好！

我正在一个相当大的项目上工作，我需要将任何内容的人类可读形式转储到日志文件中……我认为 var_export 太难阅读了。BigueNique at yahoo dot ca 有一个不错的解决方案，尽管我需要不修改传递给 dump 的任何内容。

因此，大量借鉴 BigueNique 的（只是重做了他的函数）以及对象克隆页面中某人的想法，我提出了以下函数。

它会完全复制最初传递给它的任何对象，包括所有递归定义和外部对象引用，然后执行与 BigueNique 的函数相同的功能。我还重做了它的输出内容，以满足我的需求。

<?php

function var_log(&$varInput, $var_name='', $reference='', $method = '=', $sub = false) {

 static $output ;
 static $depth ;

 if ( $sub == false ) {
 $output = '' ;
 $depth = 0 ;
 $reference = $var_name ;
 $var = serialize( $varInput ) ;
 $var = unserialize( $var ) ;
 } else {
 ++$depth ;
 $var =& $varInput ;
 
 }
 
 // 常量
 $nl = "\n" ;
 $block = 'a_big_recursion_protection_block';
 
 $c = $depth ;
 $indent = '' ;
 while( $c -- > 0 ) {
 $indent .= '| ' ;
 }

 // 如果之前解析过
 if ( is_array($var) && isset($var[$block])) {
 
 $real =& $var[ $block ] ;
 $name =& $var[ 'name' ] ;
 $type = gettype( $real ) ;
 $output .= $indent.$var_name.' '.$method.'& '.($type=='array'?'Array':get_class($real)).' '.$name.$nl;
 
 // 之前未解析过
 } else {

 // 插入递归阻止器
 $var = Array( $block => $var, 'name' => $reference );
 $theVar =& $var[ $block ] ;

 // 打印输出
 $type = gettype( $theVar ) ;
 switch( $type ) {
 
 case 'array' :
 $output .= $indent . $var_name . ' '.$method.' Array ('.$nl;
 $keys=array_keys($theVar);
 foreach($keys as $name) {
 $value=&$theVar[$name];
 var_log($value, $name, $reference.'["'.$name.'"]', '=', true);
 }
 $output .= $indent.')'.$nl;
 break ;
 
 case 'object' :
 $output .= $indent.$var_name.' = '.get_class($theVar).' {'.$nl;
 foreach($theVar as $name=>$value) {
 var_log($value, $name, $reference.'->'.$name, '->', true);
 }
 $output .= $indent.'}'.$nl;
 break ;
 
 case 'string' :
 $output .= $indent . $var_name . ' '.$method.' "'.$theVar.'"'.$nl;
 break ;
 
 default :
 $output .= $indent . $var_name . ' '.$method.' ('.$type.') '.$theVar.$nl;
 break ;
 
 }
 
 // $var=$var[$block];
 
 }
 
 -- $depth ;
 
 if( $sub == false )
 return $output ;
 
}

// var_log( $var, '$name' ) ;

?>

希望对您有所帮助！

踩

david at exposito dot mobi ¶

14年前

如果您想将数组的完整内容精确保存到一个变量中，例如稍后保存，请使用以下方法


<?php $xml = var_export($xml, true); ?> 

您将在同一个变量中获得可读的内容，而不是写入或其他任何内容

踩

kobrasrealm at gmail dot com ¶

13 年前

我编写了这个简洁的小函数，用于在 HTML 文档上使用 var_dump()，这样我就不必查看源代码了。

<?php
function htmldump($variable, $height="9em") {
echo "<pre style=\"border: 1px solid #000; height: {$height}; overflow: auto; margin: 0.5em;\">";
var_dump($variable);
echo "</pre>\n";
}
?>

您可以像这样传递参数
<?php
$sql = mysql_query("SELECT id, name, value FROM table WHERE cond = 'value'");
$s = mysql_fetch_assoc($sql);

// 转储包含 MySQL 查询结果的变量
var_dump($s);
?>

第二个参数允许您指定框的高度。默认值为 9em，但如果您预计输出量很大，则可能需要更高的值。

<?php
var_dump($s, "17em");
?>

祝您 var_dump 使用愉快。

踩

vladimir at pixeltomorrow dot com ¶

17 年前

您还可以使用 PEAR 包，可在 http://pear.php.net/package/Var_Dump 获取

它以非常友好的方式解析变量内容，比内置的 var_dump() 函数更容易“跟踪”。

当然还有很多其他的，但我更喜欢这个，因为它使用起来很简单。

只需将其添加到文件开头

<?php

require('Var_Dump.php'); // 确保php.ini中设置了pear包路径
Var_Dump::displayInit(array('display_mode' => 'HTML4_Text'), array('mode' => 'normal','offset' => 4));
?>

然后，不要简单地使用var_dump($foo)，而是使用

<?php

Var_Dump::display($foo);

?>

如果您正在寻找不同的输出布局，请阅读文档。

干杯！
弗拉基米尔·格塔乌

踩

-1

fabien dot villepinte at gmail dot com ¶

5年前

需要注意的是，输出取决于precision指令。
<?php
var_dump(10000000000000.5); // float(10000000000000)
ini_set('precision',-1);
var_dump(10000000000000.5); // float(10000000000000.5)
?>

踩

-3

divinity76 at gmail dot com ¶

13 年前

一个HTML编码的var_dump


<?php 
function htmlvardump(){ob_start(); $var = func_get_args(); call_user_func_array('var_dump', $var); echo htmentities(ob_get_clean());} 
?> 

（来源：irc.freenode.net/#php上的ekneuss / mOo）

踩

-3

jonbarnett at gmail dot com ¶

18年前

转储相互引用的对象可能导致无限递归
<?php 
$brother = new Sibling();
$sister = new Sibling();
$brother->sister = $sister;
$sister->brother = $brother;

var_dump($brother); 
/* 转储$brother的所有属性，包括“sister”，它会转储$sister的所有属性，包括“brother”等等。 */
?>

＋添加注释