預設 PHP 直接將輸出 (echo、HTML、print) 送至 SAPI (如 Apache、PHP-FPM) 再傳給瀏覽器。輸出緩衝將輸出暫存在記憶體緩衝區,**腳本結束或手動刷新前不輸出**,允許:
| 函式 | 說明 |
|---|---|
ob_start(callable $callback = null, int $chunk_size = 0, int $flags = PHP_OUTPUT_HANDLER_STDFLAGS) | 開啟緩衝,可指定回調處理輸出 |
ob_get_contents() | 取得緩衝區內容 (字串) |
ob_get_clean() | 取得內容並關閉/清空緩衝 |
ob_end_flush() | 輸出緩衝內容並關閉緩衝 |
ob_end_clean() | 丟棄緩衝內容並關閉緩衝 |
ob_flush() | 刷新緩衝到上層 (不關閉) |
ob_get_level() | 取得巢狀層級 |
<?php
function sanitizeOutput($buffer) {
// 替換敏感詞、修正連結、注入 CSRF token 等
return str_replace('php2000', 'y10k', $buffer);
}
ob_start('sanitizeOutput');
echo "hello php2000";
ob_end_flush();
// 瀏覽器收到:hello y10k
ob_start(); // Level 1: 全頁壓縮
ob_start(); // Level 2: 區塊捕獲
echo "區塊內容";
$block = ob_get_clean(); // 取得並關閉 Level 2
echo "頁首\n$block\n頁尾";
$full = ob_get_clean(); // 取得並關閉 Level 1
echo gzencode($full, 9); // 最後輸出壓縮內容
function render($template, $data) {
ob_start();
extract($data);
include $template;
return ob_get_clean();
}
$html = render('template.php', ['title' => '首頁']);
if (str_contains($_SERVER['HTTP_ACCEPT_ENCODING'] ?? '', 'gzip')) {
ob_start('ob_gzhandler'); // 內建 gzip 回調
} else {
ob_start();
}
ob_start();
try {
// 業務邏輯
renderPage();
} catch (Exception $e) {
ob_end_clean(); // 丟棄已輸出的內容
http_response_code(500);
include 'error_500.php';
}
ob_end_flush();
ob_start();
for ($i = 1; $i <= 10; $i++) {
echo "進度: $i%
";
ob_flush(); // 送到 SAPI
flush(); // SAPI 送到瀏覽器 (需關閉 gzip、proxy_buffering)
sleep(1);
}
ob_end_flush();
ob_start() 放在腳本最開頭。ob_start() 必須配對 ob_end_flush() 或 ob_end_clean(),否則記憶體洩漏。function callback(string $buffer, int $phase): string,$phase 含 PHP_OUTPUT_HANDLER_START 等旗標。output_buffering = 4096 ; 內建緩衝大小 (bytes),On=無限
; 開啟後所有腳本自動 ob_start(),但不建議依賴此設定
Response::capture()、View 渲染內部使用 obHttpFoundation\Response 管理輸出yii\web\Response 事件 EVENT_BEFORE_SEND