萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP var_dump() 函數詳解:除錯利器與變數檢視完整指南

函數用途

var_dump() 輸出變數的型別、長度、值,是 PHP 開發除錯最常用的函數。支援多參數一次輸出,陣列與物件會遞迴展開結構。

語法與特性

var_dump(mixed $value, mixed ...$values): void
  • 直接輸出到標準輸出(瀏覽器/終端機),無回傳值(回傳 null)。
  • 不需括號也可呼叫(語言構造),但建議加括號以利閱讀。
  • 受 xdebug.var_display_max_depth、xdebug.var_display_max_children 等設定限制(若安裝 Xdebug)。

實戰範例

基本型別輸出

<?php
$ta = 1;
$tb = 't';
var_dump($ta, $tb);
/*
int(1)
string(1) "t"
*/
?>

陣列與物件結構

<?php
$arr = [1, "two" => 2.5, [3, 4]];
$obj = new class { public $x = 10; protected $y = 20; };
var_dump($arr, $obj);
/*
array(3) {
  [0]=> int(1)
  ["two"]=> float(2.5)
  [2]=> array(2) { [0]=> int(3) [1]=> int(4) }
}
object(class@anonymous)#1 (2) {
  ["x"]=> int(10)
  ["y":protected]=> int(20)
}
*/
?>

進階:捕獲輸出而非直接顯示

使用輸出控制函數避免干擾頁面輸出:

<?php
ob_start();
var_dump($complexData);
$debugOutput = ob_get_clean();
// 寫入日誌、API 回傳、單元測試斷言等
file_put_contents('debug.log', $debugOutput, FILE_APPEND);
?>

var_dump() vs print_r() vs var_export()

函數型別資訊回傳值可解析 PHP 代碼適用場景
var_dump()完整無否除錯、型別檢查
print_r()基本可選字串否快速查看結構
var_export()完整可選字串是匯出設定、快取、測試資料

注意事項

  • 變數必須存在,否則觸發「Undefined variable」警告(但仍輸出 null)。
  • 遞迴參考會顯示 *RECURSION* 標記。
  • 資源型別顯示為 resource(id) of type (stream) 等。
  • 大量資料建議配合 Xdebug 獲得更佳格式化與限制控制。

實用技巧:封裝為除錯助手

<?php
function dd(...$vars) {
    echo '
';
    foreach ($vars as $v) var_dump($v);
    echo '
'; die; } // 使用 dd($user, $request->all(), $query->getSql()); ?>

var_dump() 是 PHP 開發者的「聽診器」,善用它能快速定位變數狀態異常,加速除錯流程。

copyright © 萬盛學電腦網 all rights reserved