【PHP】var_dumpの結果を文字列として取得する方法（出力バッファリング活用）

PHPのvar_dumpはデバッグ時に非常に便利ですが、その出力は直接画面へ表示されるため、文字列として扱いたい場合には工夫が必要です。「出力バッファリング」を利用することで、var_dumpの結果を簡単に文字列としてキャプチャできます。以下に具体的な実装例を示します。

コード例

<?php
    function varDumpToString($var) {
        ob_start();
        var_dump($var);
        $result = ob_get_clean();
        return $result;
    }
    // 使用例
    $data = array('first', 'second', 'third');
    $result = varDumpToString($data);
    echo $result;

このコードでは、まずob_start()で出力バッファリングを開始し、続くvar_dump()の出力を画面に表示せずバッファに蓄積します。そしてob_get_clean()を呼び出すことで、バッファの内容を取得すると同時にバッファリングを終了し、結果を文字列変数に格納しています。

通常、PHPコードの出力はブラウザ上に直接表示されますが、このような出力制御関数を使えば、任意の関数の出力を捕捉して文字列変数として保存できます。ログへの記録やメール送信、APIレスポンスへの埋め込みなど、さまざまな用途に応用可能です。

実行結果

上記のコードを実行すると、次のような出力が得られます。

array(3) { [0]=> string(5) "first" [1]=> string(6) "second" [2]=> string(5) "third" }

補足：その他の文字列化の方法

同じ仕組みはprint_rやdebug_zval_dumpなど、他の出力系関数にも応用できます。また、配列やオブジェクトを可読性の高い形式で文字列として取得したい場合は、var_export($var, true)のように第2引数にtrueを渡すだけで、出力バッファリングなしに直接文字列を受け取ることもできます。