PHPのvar_dumpを見やすく表示する5つの手法｜標準機能から最新ツールまで紹介

2026年5月15日

デバッグ

PHPでの開発作業において、変数の中身を確認するためのデバッグ作業は避けて通ることができません。

PHPには標準でvar_dumpという便利な関数が用意されていますが、デフォルトの出力結果は非常に読みづらいという課題があります。

特に多次元配列や複雑なオブジェクトを扱う場合、出力された文字列の羅列から必要な情報を探し出すのは至難の業です。

デバッグ効率を向上させることは、開発スピードを上げ、バグの早期発見につなげるための重要な鍵となります。

本記事では、2026年現在の開発現場で主流となっている、PHPのvar_dumpを見やすく表示するための5つの手法を紹介します。

初心者の方からベテランのエンジニアまで、ご自身の開発環境に最適な方法を見つけてみてください。

目次 [ close ]

1. HTMLのpreタグで囲む基本の手法

最も手軽で、追加のライブラリ導入も必要ない方法が、HTMLのpreタグを使用する手法です。

var_dumpの出力結果には改行やインデントが含まれていますが、ブラウザで表示するとこれらが無視されてしまいます。

preタグで囲むことにより、ブラウザ上でもソースコード通りの整形された状態で表示されるようになります。

PHP

$data = [
    'id' => 1,
    'name' => 'Tech User',
    'roles' => ['admin', 'editor'],
    'meta' => [
        'last_login' => '2026-05-14',
        'status' => 'active'
    ]
];

echo '<pre>';
var_dump($data);
echo '</pre>';

このコードを実行すると、ブラウザ上での見栄えが劇的に改善されます。

実行結果

array(4) {
  ["id"]=>
  int(1)
  ["name"]=>
  string(9) "Tech User"
  ["roles"]=>
  array(2) {
    [0]=>
    string(5) "admin"
    [1]=>
    string(6) "editor"
  }
  ["meta"]=>
  array(2) {
    ["last_login"]=>
    string(10) "2026-05-14"
    ["status"]=>
    string(6) "active"
  }
}

非常にシンプルですが、外部ライブラリをインストールできない制限された環境では最も信頼できる方法です。

毎回タグを記述するのが面倒な場合は、独自のヘルパー関数を作成して使い回すのが一般的です。

ただし、この方法はあくまでテキストを整形するだけであり、折りたたみ機能などは利用できません。

2. Xdebug拡張モジュールの導入

本格的なPHP開発環境を構築するなら、Xdebugを導入するのが最も推奨される解決策です。

XdebugはPHPの拡張モジュールであり、これを有効化するだけでvar_dumpの出力が自動的にカラーリングされ、構造化されます。

さらに、配列の階層が深い場合でも、見やすく整理された状態で表示されるようになります。

Xdebugをインストールすると、php.iniの設定に基づいて出力がカスタマイズされます。

PHP

// Xdebugが有効な環境で実行
var_dump($data);

Xdebugが有効な場合、特別な記述をしなくても以下のようなリッチな出力が得られます。

実行結果

/var/www/html/index.php:12:
array (size=4)
  'id' => int 1
  'name' => string 'Tech User' (length=9)
  'roles' => 
    array (size=2)
      0 => string 'admin' (length=5)
      1 => string 'editor' (length=6)
  'meta' => 
    array (size=2)
      'last_login' => string '2026-05-14' (length=10)
      'status' => string 'active' (length=6)

Xdebugは単に見栄えを良くするだけでなく、スタックトレースの表示やステップ実行などの高度なデバッグ機能も提供します。

ローカル開発環境（Dockerなど）では必須級のツールと言えるでしょう。

ただし、本番環境で有効にするとパフォーマンスの低下や情報漏洩のリスクがあるため、注意が必要です。

3. Symfony VarDumper（dump関数）の活用

モダンなPHP開発において、最も人気のあるライブラリの一つが「Symfony VarDumper」です。

このライブラリを使用すると、dump()という非常に強力な関数が使えるようになります。

Symfonyフレームワークだけでなく、単体のライブラリとしてどんなプロジェクトにもComposer経由で導入可能です。

導入するには、以下のコマンドを実行します。

Shell

composer require --dev symfony/var-dumper

インストール後、コード内でdump()関数を呼び出すだけで、非常に美しいインターフェースで変数が表示されます。

PHP

require 'vendor/autoload.php';

$data = [
    'title' => 'PHP Tips',
    'tags' => ['coding', 'php8'],
    'date' => new DateTime()
];

dump($data);

Symfony VarDumperの最大の特徴は、ブラウザ上で構造をマウス操作で折りたためる点にあります。

巨大な配列やオブジェクトを解析する際、不要な階層を閉じて必要な部分だけを集中して確認できます。

また、コマンドライン（CLI）環境でも自動的に色付けが行われるため、ターミナル上での確認も非常に快適です。

2026年現在、多くのプロフェッショナルな現場で標準的に採用されている手法です。

4. Laravelのdd関数とdump関数の利便性

世界的にシェアの高いフレームワークであるLaravelを使用している場合、標準で便利なデバッグ関数が組み込まれています。

それがdump()関数とdd()関数です。

ddは「Dump and Die」の略で、変数の内容を表示した直後にプログラムの実行を停止させます。

PHP

// Laravel環境での使用例
$users = User::all();

dd($users);

echo "この行は実行されません";

Laravelのdd()関数は、内部的に前述のSymfony VarDumperを利用しており、非常に見やすく多機能です。

検索機能が備わっていたり、ダークモードに対応していたりと、開発者のストレスを最小限に抑える工夫が凝らされています。

Laravel以外のプロジェクトでも、spatie/laravel-rayなどのパッケージを導入することで、さらに高度なデバッグ体験が得られます。

フレームワークの恩恵を最大限に活かすことで、デバッグ時間を大幅に短縮できるでしょう。

5. サードパーティ製デバッグツール「Ray」や「Kint」の導入

特定のフレームワークに依存せず、よりリッチな表示を求める場合は「Kint」や「Ray」といった専用ツールが選択肢に入ります。

「Kint」は古くから愛されているライブラリで、ゼロ構成で導入でき、詳細な情報を美しく表示します。

PHP

require 'kint.phar';

Kint::dump($data);

Kintは、変数の値だけでなく、その変数が定義されているファイル名や行数、さらにはメモリの使用量まで表示してくれるのが特徴です。

一方、近年注目を集めているのが「Ray」というデスクトップアプリと連携するツールです。

Rayを使用すると、ブラウザの画面を汚すことなく、専用のアプリケーションウィンドウにデバッグ情報を送信できます。

PHP

ray($data);

画面レイアウトを崩さずにデータだけを別画面で追いたい場合に、これ以上ないほど便利なツールです。

これらは有料、または特定のライブラリ導入が必要ですが、投資に見合うだけの生産性向上が期待できます。

各手法の比較まとめ

ここまで紹介した5つの手法について、それぞれの特徴を比較表にまとめました。

手法	導入難易度	主なメリット	推奨環境
preタグ利用	極めて低い	追加設定なしですぐに使える	制限の多いサーバー環境
Xdebug	中（要設定）	標準機能が自動で強化される	ローカル開発環境
Symfony VarDumper	低（Composer）	折りたたみ可能で非常に見やすい	モダンなPHPプロジェクト全般
Laravel dd()	不要（Laravel内）	実行停止機能があり、最も手軽	Laravel開発
Ray / Kint	低〜中	別ウィンドウ表示など高度な機能	生産性を追求するプロ現場