PHP ob_start() 輸出緩衝控制完整詳解與實戰應用

什麼是輸出緩衝

預設 PHP 腳本輸出 (`echo`、`print`、HTML 區塊) 直接送往瀏覽器。開啟輸出緩衝後，輸出資料暫存於記憶體緩衝區，**不立即發送**，直到腳本結束或手動 `flush()`/`ob_end_flush()`。這解決了「輸出後無法送出 Header」的經典問題。

核心函式速查

經典應用場景

1. 輸出後送出 Header / Cookie / Session

<?php
ob_start();
echo "Hello "; // 不會立即輸出
header("Location: index.php"); // 正常運作，未觸發 "Headers already sent"
ob_end_flush();

2. 捕獲輸出內容進一步處理 (模板引擎核心)

<?php
ob_start();
include 'template.php'; // 模板輸出到緩衝區
$content = ob_get_contents(); // 取得渲染後字串
ob_end_clean();

// 後處理：關鍵字替換、壓縮、快取
$content = str_replace('{SITE_NAME}', 'MySite', $content);
file_put_contents('cache/page.html', $content);
echo $content;

3. 靜態頁面生成

ob_start();
// 複雜邏輯、資料庫查詢、視圖渲染
$this->load->view('page', $data);
$html = ob_get_contents();
ob_end_clean();

$fp = fopen('public/page.html', 'w');
fwrite($fp, $html);
fclose($fp);

4. 保存 phpinfo() 等直接輸出函式結果

ob_start();
phpinfo();
$info = ob_get_contents();
ob_end_clean();
file_put_contents('phpinfo.html', $info);

5. GZIP 壓縮輸出 (舊版 PHP 手動實作)

ob_start('ob_gzhandler'); // 自動偵測瀏覽器支援並壓縮
// 或手動
ob_start();
echo $content;
$gz = gzencode(ob_get_contents(), 9);
header('Content-Encoding: gzip');
header('Content-Length: ' . strlen($gz));
echo $gz;

6. 即時輸出長時間任務進度

<?php
ob_implicit_flush(true); // 等同 ob_implicit_flush(1)
header('Content-Type: text/plain');

for ($i = 1; $i <= 10; $i++) {
    echo "Processing step $i...\n";
    sleep(1); // 模擬耗時操作
}
// 瀏覽器會逐行顯示，不等全部結束

進階：巢狀緩衝區

可多次呼叫 `ob_start()`，形成堆疊。`ob_end_flush()`/`ob_end_clean()` 僅操作**最內層**緩衝區。

ob_start(); // Level 1
echo "A";
ob_start(); // Level 2
echo "B";
$inner = ob_get_clean(); // 取得 "B"，關閉 Level 2
echo "C";
$outer = ob_get_clean(); // 取得 "AC"，關閉 Level 1
echo $outer . $inner; // ACB

效能與記憶體考量

• 大量輸出 (如 100MB 檔案下載) **勿使用** `ob_start()`，直接 `readfile()` 或 `fpassthru()` 串流輸出。
• 緩衝區預設無大小限制，記憶體耗盡風險。長時間腳本建議分段 `ob_flush()` + `flush()`。
• `ob_gzhandler` 壓縮需 CPU，高流量建議由 Nginx/Apache `mod_deflate`/`gzip` 處理。

常見錯誤與除錯

最佳實務建議

1. **框架統一管理**：CodeIgniter/Laravel/Symfony 內建輸出緩衝，直接使用框架提供的 `view()`/`response()` 機制。
2. **模板引擎核心**：Blade、Twig、Smarty 皆以 `ob_start()`/`ob_get_clean()` 實作渲染捕獲。
3. **避免濫用**：簡單頁面無需手動控制，讓 PHP 預設行為即可。
4. **除錯工具**：`ob_get_level()` 回傳目前緩衝層數，`var_dump(ob_get_status(true))` 顯示所有緩衝區狀態。

1. 上一篇文章： wkhtmltopdf：HTML 轉 PDF 最強方案，支援分頁、CSS、JS 渲染
2. 下一篇文章： Yii 框架原始碼深度分析：組件化、MVC、系統組件與 ORM 核心架構

PHP 相關知識

PHP cURL 多線程並發下載圖片：curl_multi 實戰、超時控制與記憶體優化

場景與優勢 批量抓取遠程圖片（如采集、同步、備份）時，串行請

緩存實戰指南：Memcache 與 Redis 核心操作、鍵名設計與 PHP 封裝模式

緩存實戰指南：Memcache 與 Redis 核心操作、鍵

openSUSE 42.1 下編譯安裝 PHP 7 完整指南

背景 openSUSE 42.1 官方倉庫無 PHP 7 包

PHP 陣列與 XML 互相轉換完全指南

PHP 陣列與 XML 互相轉換完全指南 在現代 Web 開