PHP 輸出緩存區控制函數 ob 系列深度解析

PHP 的輸出緩存（Output Buffering）機制允許腳本將輸出暫存在內存緩存區，而非直接發送給瀏覽器。掌握 ob_start()、ob_get_contents()、ob_get_flush() 等函數的區別，對優化頁面加載、實現模板引擎、捕獲輸出至關重要。

核心函數對比

關鍵差異：ob_get_flush() vs ob_end_flush()

$buf = ob_get_flush(); // 相當於 ob_end_flush()，但多返回緩存區字符串
// 此時緩存區已關閉並發送給瀏覽器，再調用 ob_get_contents() 將返回空字符串

ob_get_flush() = ob_get_contents() + ob_end_flush() 的原子操作，避免了中間狀態不一致。

實戰代碼演示

<?php
for ($i = 0; $i < 10; $i++) {
    ob_start();
    echo "This is iteration $i: ";
    // 錯誤示範：獲取後清空，導致內容丟失
    // $buf = ob_get_contents();
    // ob_clean();

    // 正確：一次性獲取並發送，關閉緩存
    $buf = ob_get_flush();

    // 緩存區已關閉，ob_get_contents() 返回空
    $test = ob_get_contents();
    echo $test . "---->"; // 輸出空字符串
    echo $buf;            // 輸出真實內容
    echo memory_get_usage() . " ";
    echo "<br />";
}
?>

常見應用場景

1. 模板引擎渲染：捕獲 include 視圖文件輸出，賦值給變量再佈局。
2. 頁面靜態化：ob_start() → 業務邏輯 → file_put_contents(ob_get_clean()) 生成靜態 HTML。
3. 壓縮輸出：ob_start('ob_gzhandler') 自動 Gzip 壓縮輸出。
4. 異步下載大文件：分塊 ob_flush() + flush() 逐步發送，避免內存峰值。

避坑指南

• 嵌套 ob_start() 時，每層需對應 ob_end_flush()/clean()，否則外層捕獲不到內容。
• ob_get_flush() 後緩存區已關閉，不可再調用任何 ob_* 函數**（除非重新 ob_start()）。
• CLI 模式下輸出緩存行為與 Web SAPI 不同，測試時注意區分。