HTTP 響應由 Header(頭部) 與 Body(主體) 組成,中間以空行分隔。PHP 腳本執行時,Header 信息(來自 header()、setcookie())會被緩存,直到首次輸出 Body 內容時才會發送所有 Header 並結束 Header 階段。
經典錯誤場景:
<?php
echo "Hello"; // 輸出 Body,隱式發送 Header 並結束 Header 階段
header("Location: x"); // 錯誤!Header 已發送,無法修改
?>
啟用 OB 後,PHP 將所有輸出(包括 echo、print、HTML 代碼塊)捕獲到內存緩衝區,延遲 Header 發送,直到腳本結束或手動刷新。這打破了「輸出即發送」的限制,允許在輸出內容後修改 Header/設置 Cookie。
| 函數 | 作用 | 返回值 |
|---|---|---|
ob_start(callable $callback=null, int $chunk_size=0, int $flags=PHP_OUTPUT_HANDLER_STDFLAGS) | 啟用輸出緩衝,可選回調處理輸出 | bool |
ob_get_contents() | 獲取緩衝區內容(字符串) | string|false |
ob_end_flush() | 發送緩衝區內容並關閉緩衝 | bool |
ob_end_clean() | 丟棄緩衝區內容並關閉緩衝 | bool |
ob_get_clean() | 獲取內容並清空緩衝(等同 get_contents + end_clean) | string |
ob_get_flush() | 獲取內容並發送輸出(等同 get_contents + end_flush) | string |
ob_flush() | 發送緩衝區內容但保持緩衝開啟 | bool |
ob_clean() | 清空緩衝區但保持緩衝開啟 | bool |
<?php
ob_start(); // 啟用緩衝
echo "<html><body>歡迎, \$user</body></html>";
setcookie("Wow", "即使已輸出內容也能設置 Cookie!"); // 正常工作
?>
<?php
ob_start();
echo "計算字符串長度的笨辦法...";
$length = strlen(ob_get_contents()); // 獲取緩衝區長度
ob_end_clean(); // 丟棄緩衝,不輸出
echo "實際長度: $length";
?>
<?php
function render($template, $data) {
extract($data);
ob_start();
include $template; // 模板中可使用 $var 直接輸出
return ob_get_clean();
}
echo render('template.php', ['title' => '首頁', 'content' => '內容...']);
?>
OB 支持棧式嵌套,內層 ob_end_flush() 將內容輸出到外層緩衝:
<?php
ob_start(); // Level 1
echo "外層開始\n";
ob_start(); // Level 2
echo "內層內容\n";
$inner = ob_get_clean(); // 獲取並清空 Level 2
echo "捕獲到內層: $inner";
ob_end_flush(); // 輸出 Level 1
?>
ob_start() 接受回調函數,可對輸出進行過濾、壓縮、替換:
<?php
function sanitize_output($buffer) {
// 移除調試註釋
$buffer = preg_replace('/<!--.*?-->/s', '', $buffer);
// 壓縮空白
$buffer = preg_replace('/\s+/', ' ', $buffer);
return $buffer;
}
ob_start('sanitize_output');
echo "<html> <body> Hello </body> </html>";
ob_end_flush();
// 輸出: Hello
?>
; php.ini
output_buffering = 4096 ; 啟用內建緩衝,值為緩衝區大小(字節),On/4096 為推薦值
; 等同於每個腳本自動調用 ob_start()
; 生產環境建議開啟,可減少系統調用次數,提升 5-15% 輸出效能
ob_flush() + flush() 實現漸進式輸出zlib.output_compression = On 自動 GZIP 壓縮ob_get_status(true) 獲取所有緩衝層級狀態| 陷阱 | 症狀 | 解決方案 |
|---|---|---|
| 雙重緩衝 | 內容重複、Header 異常 | 檢查 php.ini + 代碼中重複 ob_start() |
| 異常中斷 | 緩衝區未刷新導致輸出丟失 | 註冊 register_shutdown_function 兜底刷新 |
| CLI 模式 | OB 行為與 Web SAPI 不一致 | CLI 默認無緩衡,需顯式啟用 |
| 輸出回調異常 | 回調拋出異常導致輸出截斷 | 回調內捕獲異常,返回原始緩衝 |