PHP 輸出緩衝區（Output Buffering）深度解析：原理、配置、函數、實戰場景全覆蓋

什麼是輸出緩衝區？

輸出緩衡區是 PHP 在將內容發送給 Web 伺服器（Apache/Nginx）前，在記憶體中暫存輸出數據的機制。它解決了「輸出內容後無法發送 Header」的經典問題，並支援靜態快取、分段輸出大文件、Gzip 壓縮等高級用法。

PHP 輸出流向圖

PHP 腳本
    ↓ echo/print/var_dump 等輸出語句
PHP 內部輸出緩衝區 (ob_* 系列控制)
    ↓ ob_flush() / 隱式刷新 / 腳本結束
Web 伺服器緩衝區 (Apache/Nginx)
    ↓ flush() / 隱式刷新 / 響應結束
瀏覽器

兩層緩衝區：PHP 層（ob_*）與 Web 伺服器層（flush 影響）。

核心配置：php.ini

建議：生產環境設 output_buffering = 4096，開發環境可設 Off 便於即時看到輸出。

輸出緩衝區核心函數完整表

關鍵順序：ob_flush() 必須在 flush() 之前

// 正確：先推送到 Web 伺服器，再推送到瀏覽器
ob_flush();
flush();

// 錯誤：Web 伺服器緩衝區為空，flush() 無效
flush();
ob_flush();

實戰場景全解析

場景一：解決「Header already sent」錯誤

<?php
ob_start(); // 開啟緩衝，所有 echo 暫存
echo "歡迎訪問"; // 實際未輸出到瀏覽器
header('Location: /login.php'); // 可以正常發送 Header
ob_end_flush(); // 最後統一輸出

場景二：大文件下載（突破 memory_limit）

<?php
$file = '/path/to/large_video.mp4';
$size = filesize($file);

header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($file) . '"');
header('Content-Length: ' . $size);
header('Accept-Ranges: bytes');

ob_end_clean(); // 確保無殘留輸出
$fp = fopen($file, 'rb');
while (!feof($fp)) {
    echo fread($fp, 8192); // 每次 8KB
    ob_flush();
    flush(); // 立即推送到瀏覽器
}
fclose($fp);

關鍵：分塊讀取 + ob_flush + flush，PHP 記憶體佔用恆定在 8KB，不受 memory_limit 限制。

場景三：靜態頁面快取（生成 HTML 檔）

<?php
$cacheFile = "cache/page_{$id}.html";
$expire = 3600;

if (file_exists($cacheFile) && time() - filemtime($cacheFile) < $expire) {
    readfile($cacheFile);
    exit;
}

ob_start();
// 複雜邏輯、資料庫查詢、模板渲染...
$content = ob_get_contents();
file_put_contents($cacheFile, $content);
ob_end_flush();

場景四：即時日誌/進度條/Server-Sent Events

<?php
header('Content-Type: text/event-stream');
header('Cache-Control: no-cache');
header('X-Accel-Buffering: no'); // 關閉 Nginx 緩衝

ob_implicit_flush(true);
ob_end_flush();

for ($i = 1; $i <= 100; $i++) {
    echo "data: 進度 $i%\n\n";
    ob_flush();
    flush();
    sleep(1);
}

場景五：Gzip 壓縮輸出

<?php
// 方式一：php.ini 開啟 zlib.output_compression = On
// 方式二：代碼控制
if (strpos($_SERVER['HTTP_ACCEPT_ENCODING'], 'gzip') !== false) {
    ob_start('ob_gzhandler');
} else {
    ob_start();
}
// 後續輸出自動壓縮

瀏覽器與 Web 伺服器的「隱形門檻」

常見錯誤與避坑

• 巢狀 ob_start() 未正確配對：每個 ob_start() 必須對應 ob_end_flush() 或 ob_end_clean()，否則緩衝區洩漏導致輸出重複/缺失。
• ob_get_contents() 在 ob_end_clean() 後調用返回空字串。
• CLI 模式下 flush() 無效：CLI 無 Web 伺服器層，直接輸出到終端，通常無需 flush。
• 忘記 session_write_close()：長時間流式輸出時，Session 檔案鎖會阻塞同用戶其他請求。

總結

輸出緩衝區是 PHP 從「模板引擎」進化為「現代 Web 框架基礎設施」的關鍵技術。掌握 雙層緩衝架構、ob_flush/flush 順序、分塊輸出突破記憶體限制、回調處理器，能解決 Header 錯誤、大文件下載、即時推送、靜態快取、Gzip 壓縮等核心問題。記住：輸出控制權在你手中，不要讓緩衝區控制你。