PHP ob_flush() 與 flush() 正確順序與輸出緩衝機制詳解

PHP ob_flush() 與 flush() 正確順序與輸出緩衝機制詳解

PHP 輸出經過兩層緩衝：PHP 內部緩衝 → Web 伺服器緩衝 → 瀏覽器。`ob_flush()` 刷新 PHP 層，`flush()` 刷新伺服器層。**正確順序：先 `ob_flush()` 再 `flush()`**。本文詳解機制、常見誤區與實際應用。

緩衝層級架構

PHP 腳本
    ↓ echo/print
PHP 內部輸出緩衝 (ob_start 開啟)
    ↓ ob_flush()
Web 伺服器緩衝 (Apache/Nginx/FastCGI)
    ↓ flush()
瀏覽器接收並渲染

正確使用範例：即時輸出進度

<?php
// 關鍵：必須先開啟輸出緩衝或確保無輸出前已輸出 header
// 此處為演示，實際生產需注意 header 已發送問題

echo str_repeat(' ', 1024); // 填滿瀏覽器緩衝觸發顯示（某些瀏覽器需要）

for ($i = 0; $i < 4; $i++) {
    echo "步驟 $i 完成
\n";
    
    // 正確順序：先 PHP 層，再伺服器層
    ob_flush();
    flush();
    
    sleep(1); // 模擬耗時操作
}
?>

關鍵配置要求

1. php.ini：`output_buffering = Off` 或 `0`（預設常為 4096，需關閉或用 `ob_start()` 控制）。
2. Web 伺服器：
   • Apache：`mod_deflate`、`mod_gzip` 可能干擾，需在 `.htaccess` 關閉 `SetEnv no-gzip 1`。
   • Nginx + FastCGI：`fastcgi_buffering off;` 在 location 區塊。
3. 瀏覽器：部分瀏覽器需接收一定量數據（如 256~1024 字節）才開始渲染，可用 `str_repeat(' ', 1024)` 填充。

常見錯誤與解決

進階：封裝即時輸出類

class RealtimeOutput {
    public static function init() {
        @ini_set('output_buffering', 'Off');
        @ini_set('zlib.output_compression', 'Off');
        ob_implicit_flush(true);
        ob_start();
        echo str_repeat(' ', 1024); // 觸發瀏覽器渲染
    }
    
    public static function write($msg) {
        echo $msg . "
\n";
        ob_flush();
        flush();
    }
    
    public static function end() {
        ob_end_flush();
    }
}

// 使用
RealtimeOutput::init();
for ($i = 0; $i < 10; $i++) {
    RealtimeOutput::write("處理項目 $i");
    usleep(500000);
}
RealtimeOutput::end();

應用場景

• 長時間任務進度顯示（匯入、匯出、報表生成）
• 即時日誌串流
• Server-Sent Events (SSE) 簡易實現
• 大檔案分塊下載進度

現代替代方案

• WebSocket：雙向實時通訊，適合高頻互動。
• Server-Sent Events：單向伺服器推送，HTTP/2 多路復用友好。
• 前端輪詢 / 長輪詢：簡單相容，但較耗資源。

掌握 `ob_flush`/`flush` 正確順序與緩衝層級配置，能實現傳統 HTTP 下的即時輸出體驗。