輸出緩衡機制核心概念
PHP 輸出緩衝允許腳本將輸出暫存於記憶體，而非直接發送至瀏覽器。這帶來三大優勢：內容後處理（壓縮、替換、捕獲）、流量控制（分塊發送、長連線）、標頭延遲發送（在輸出內容前仍可修改 Header/Cookie/Session）。本文系統整理核心函數、常見模式與實戰範例。
核心函數速查表
| 函數 | 用途 | 回傳值 |
|---|
ob_start(callable $callback=null, int $chunk_size=0, int $flags=PHP_OUTPUT_HANDLER_STDFLAGS) | 開啟緩衝，可指定回調處理輸出 | bool |
ob_get_contents() | 取得緩衝區內容（不清空） | string|false |
ob_get_clean() | 取得內容並關閉緩衝 | string |
ob_end_flush() | 發送緩衝內容並關閉緩衝 | bool |
ob_end_clean() | 丟棄緩衝內容並關閉緩衝 | bool |
ob_flush() | 發送緩衝內容（不關閉） | bool |
flush() | 將 PHP/WEB 伺服器緩衝推送至瀏覽器 | void |
ob_get_level() | 取得巢狀緩衝層級 | int |
ob_list_handlers() | 列出當前啟用的處理器 | array |
output_add_rewrite_var() | URL 重寫自動加入參數（表單 action、連結 href） | bool |
output_reset_rewrite_vars() | 重置 URL 重寫變數 | bool |
實戰範例 1：GZIP 壓縮輸出（ob_gzhandler）
<?php
// 必須在任何輸出前呼叫
ob_start('ob_gzhandler'); // 自動檢測瀏覽器 Accept-Encoding，支援 gzip/deflate
echo "Hello World
";
// 大量 HTML...
// 腳本結束自動 ob_end_flush()
// 或手動控制
// ob_end_flush();
?>
注意：ob_gzhandler 會自動發送 Content-Encoding: gzip 標頭，若已手動 header('Content-Encoding: ...') 會衝突。生產環境建議在 Nginx/Apache 層開啟 gzip，PHP 層關閉以減少 CPU 消耗。
實戰範例 2：自訂回調處理（關鍵字替換、模板渲染）
<?php
ob_start(function ($buffer) {
// 1. 移除開發環境註解
$buffer = preg_replace('/.*?/s', '', $buffer);
// 2. 替換版本號
$buffer = str_replace('{VERSION}', '1.2.3', $buffer);
// 3. CSS/JS 版本戳（快取破壞）
$buffer = preg_replace('/(]+href="[^"]+\.css)(")/i', '$1?v=123$2', $buffer);
$buffer = preg_replace('/(]+src="[^"]+\.js)(")/i', '$1?v=123$2', $buffer);
return $buffer;
});
include 'template/header.php';
echo $dynamicContent;
include 'template/footer.php';
// 輸出時自動經過回調處理
?>
實戰範例 3：捕獲視圖輸出變數（MVC View 渲染）
class View {
public static function render(string $template, array $data = []): string {
extract($data, EXTR_SKIP);
ob_start();
include $template;
return ob_get_clean();
}
}
// 使用
$html = View::render('views/article.php', [
'title' => '文章標題',
'body' => '內容...
'
]);
// 可進一步處理 $html，或直接 echo
echo $html;
實戰範例 4：長時間任務分塊輸出（進度條、串流）
<?php
// 必須關閉輸出緩衝或設定 chunk_size
// 方案 A：隱式刷新（需 Web 伺服器支援）
@ini_set('implicit_flush', 1);
@ini_set('output_buffering', 0); // 可能被 php.ini 覆蓋
// 方案 B：手動 ob_flush + flush
ob_start();
for ($i = 1; $i <= 10; $i++) {
echo "處理步驟 $i / 10...
";
// 關鍵：將緩衝推送至瀏覽器
ob_flush();
flush();
sleep(1); // 模擬耗時操作
}
echo "完成！
";
ob_end_flush();
// Nginx 需關閉 proxy_buffering：
// proxy_buffering off;
// fastcgi_buffering off; (若用 PHP-FPM)
實戰範例 5：URL 重寫自動加入參數（Session ID 傳遞）
<?php
session_start();
// 自動在所有 、
巢狀緩衝與層級控制
<?php
ob_start(); // Level 1
echo "A";
ob_start(); // Level 2
echo "B";
$level2 = ob_get_clean(); // 取得 "B"，關閉 Level 2
ob_start(); // Level 2 (新)
echo "C";
$level2b = ob_get_clean(); // 取得 "C"
$level1 = ob_get_clean(); // 取得 "A"，關閉 Level 1
echo "Level1: $level1\n"; // A
echo "Level2a: $level2\n"; // B
echo "Level2b: $level2b\n"; // C
?>
常見陷阱與除錯技巧
| 問題 | 原因 | 解決 |
|---|
| Header already sent | ob_start 前已有輸出（空白、BOM、錯誤訊息） | 檔案開頭無空白、UTF-8 無 BOM、錯誤導向日誌 |
| ob_gzhandler 無效 | zlib.output_compression=On 衝突 | php.ini 關閉 zlib.output_compression |
| flush() 不生效 | Nginx proxy_buffering、Apache mod_deflate、瀏覽器緩衝 | 關閉 proxy_buffering、設定 chunk_size、前端加足夠內容觸發渲染 |
| 記憶體耗盡 | 大量輸出未釋放緩衝 | 分塊 ob_flush、或直接 echo 不開啟 ob_start |
| Session/Cookie 失效 | 輸出前未開啟 ob_start，導致 header 過早發送 | 入口檔案最開頭 ob_start() |
效能優化建議
- 靜態內容不開啟 ob_start：直接 echo，避免記憶體複製。
- 大檔案下載：使用
readfile() 或分塊 fread + ob_flush/flush，不要載入整檔到緩衝。
- API/JSON 端點：通常不需緩衝，直接
header('Content-Type: application/json'); echo json_encode($data);
- 模板引擎：若使用 Twig/Blade/Smarty，其內部已處理緩衝，外層無需再包
ob_start。
- 生產環境：
output_buffering = 4096（php.ini）提供基礎緩衝，減少系統呼叫開銷。
