| 函數 | 用途 |
|---|---|
ob_start(callable $callback = null, int $chunk_size = 0, int $flags = 0) | 開啟輸出緩衋,可選回調處理輸出內容 |
ob_get_contents() | 取得緩衝區內容(字串),不清空緩衝區 |
ob_get_clean() | 取得內容並關閉並清空緩衝區(等同 ob_get_contents() + ob_end_clean()) |
ob_end_flush() | 輸出緩衝區內容並關閉緩衝 |
ob_end_clean() | 丟棄緩衝區內容並關閉緩衝 |
ob_get_level() | 取得目前巢狀緩衝層級 |
ob_implicit_flush(bool $flag) | 控制隱性刷新(每次 echo/print 即送出) |
var_dump / print_r 輸出供記錄或模板使用<?php
function dumpToString(mixed $var): string
{
ob_start();
var_dump($var);
return ob_get_clean();
}
$debugInfo = dumpToString($complexObject);
// 現在可寫入日誌、郵件、或傳給模板引擎
$logger->debug($debugInfo);
?>
在輸出任何內容前呼叫 ob_start(),所有後續輸出(含 echo、HTML、錯誤訊息)皆暫存緩衝區,允許後續呼叫 header()、setcookie()、session_start()。
<?php
// 入口檔案最頂部
ob_start();
// ... 業務邏輯可能包含 echo、include 視圖 ...
// 最後統一輸出或處理
$content = ob_get_clean();
echo $content;
?>
<?php
// 入口檔案最早處
ob_start(function ($buffer) {
// 僅在客戶端支援且內容非二進位時壓縮
if (
!headers_sent() &&
stripos($_SERVER['HTTP_ACCEPT_ENCODING'] ?? '', 'gzip') !== false &&
!preg_match('/\b(?:image|audio|video|pdf|zip|gz)\b/i', $_SERVER['CONTENT_TYPE'] ?? '')
) {
header('Content-Encoding: gzip');
return gzencode($buffer, 9, FORCE_GZIP);
}
return $buffer;
});
// 後續正常輸出
echo '大量 HTML 內容...';
?>
現代專案建議由 Nginx/Apache (mod_deflate/gzip) 或 CDN 層處理壓縮,PHP 層僅作為備援或特殊需求。
<?php
// 簡易模板引擎核心
function render(string $templateFile, array $data = []): string
{
extract($data, EXTR_SKIP); // 將陣列鍵變為變數
ob_start();
include $templateFile; // 模板中可直接使用 $title, $items 等
return ob_get_clean();
}
// 使用
echo render('views/page.php', [
'title' => '首頁',
'items' => ['蘋果', '香蕉', '橘子'],
]);
// views/page.php
// <h1><?= $title ?></h1>
// <ul><? foreach ($items as $item): ?><li><?= $item ?></li><? endforeach ?></ul>
?>
<?php
ob_start(); // Level 1: 頁面整體
echo '<html><body>';
ob_start(); // Level 2: 側邊欄
include 'sidebar.php';
$sidebar = ob_get_clean();
ob_start(); // Level 2: 主內容
include 'main.php';
$main = ob_get_clean();
echo $main . $sidebar;
echo '</body></html>';
$page = ob_get_clean(); // 取得完整頁面
// 可進一步壓縮、快取、或輸出
echo $page;
?>
ob_get_level() 除錯。readfile()、fpassthru() 或 Generator 逐塊輸出,勿全量緩衝。header() 呼叫。輸出緩衝是 PHP 靈活控制 HTTP 回應的核心機制。從簡單的除錯輸出捕獲、解決 Header 錯誤,到模板引擎渲染、頁面壓縮、區塊組合,掌握 ob_* 家族函數能讓你在框架底層、中介軟體、自訂回應處理中遊刃有餘。現代框架(Laravel, Symfony, Slim)皆大量依賴此機制,理解其運作原理有助於深度除錯與擴充。