導入
PHPの開発中、配列やオブジェクトの中身を確認する際に var_dump() や print_r() を多用する方は多いでしょう。しかし、ブラウザに直接出力できないcronジョブやAPIのバックグラウンド処理では、これらの関数は役に立ちません。標準出力が破棄される、あるいはログファイルに混入して解析が困難になるからです。本記事では、出力バッファリング（Output Buffering）を活用して、動的なデバッグ情報をスマートにログファイルとして保存する方法を解説します。
基礎知識
通常、PHPで echo や var_dump() を実行すると、その内容は即座にブラウザやコンソールへ出力されます。しかし、ob_start() 関数を呼び出すと、PHPの出力処理が一度メモリ（バッファ）に蓄積されるようになります。この仕組みを利用することで、本来画面に表示されるはずの文字列を、変数に代入したり、ファイルへ書き込んだりすることが可能になります。
実装/解決策
デバッグしたいコードを ob_start() と ob_end_clean() で挟みます。
1. ob_start() で出力バッファリングを開始する。
2. デバッグ対象の関数（var_dump等）を実行する。
3. ob_get_contents() でバッファの内容を文字列として取得する。
4. ob_end_clean() でバッファを破棄し、出力バッファリングを終了する。
この手順を踏むことで、画面を汚さずに詳細な構造データをテキストファイルとして抽出できます。
サンプルプログラム
以下のコードは、複雑な配列データをファイルへ安全に書き出す例です。実務では、タイムスタンプを付与することでログの追跡性を高めるのがコツです。
/
function saveDebugLog($data, $filename = ‘debug_log.txt’) {
// 出力バッファリングを開始
ob_start();
// 中身を確認したい変数をダンプ
var_dump($data);
// バッファに溜まった内容を取得
$content = ob_get_contents();
// バッファをクリアして終了
ob_end_clean();
// タイムスタンプを付与してファイルに追記
$logEntry = “[” . date(‘Y-m-d H:i:s’) . “]\n” . $content . “\n”;
file_put_contents($filename, $logEntry, FILE_APPEND);
}
// 動作確認用のサンプルデータ
$user = [
‘id’ => 101,
‘name’ => ‘PHP Engineer’,
‘roles’ => [‘admin’, ‘editor’]
];
// 実行
saveDebugLog($user);
?>
応用・注意点
実務でこの手法を用いる際の注意点がいくつかあります。
一つ目は、メモリ消費量です。非常に巨大な配列をダンプすると、バッファにすべて展開されるためメモリ不足（Memory Exhausted）を引き起こす可能性があります。巨大なデータの場合は、foreachでループさせて個別に書き出すなどの工夫が必要です。
二つ目は、パーミッションです。cronで実行する場合、Webサーバーの実行ユーザーとcronのユーザーが異なると、ログファイルへの書き込み権限エラーが発生することがあります。ファイルの所有権と書き込み権限は必ず事前に確認してください。
また、本番環境では必ずこの処理を削除するか、環境変数で制御してデバッグログが出力されないようにするガード句を忘れないようにしましょう。