萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 輸出緩衝控制 (ob_start/ob_end_flush) 完整指南:原理、巢狀緩衝、回調處理與實戰應用

什麼是輸出緩衝?

預設 PHP 直接將輸出 (echo、HTML、print) 送至 SAPI (如 Apache、PHP-FPM) 再傳給瀏覽器。輸出緩衝將輸出暫存在記憶體緩衝區,**腳本結束或手動刷新前不輸出**,允許:

  • 修改 HTTP Header (setcookie、header) 在輸出後
  • 捕獲輸出內容進行處理 (壓縮、替換、記錄)
  • 錯誤時丟棄輸出,改顯示錯誤頁面

核心函式

函式說明
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)

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); // 最後輸出壓縮內容

實戰應用場景

1. 模板引擎捕獲輸出

function render($template, $data) {
    ob_start();
    extract($data);
    include $template;
    return ob_get_clean();
}

$html = render('template.php', ['title' => '首頁']);

2. 頁面壓縮輸出 (Gzip)

if (str_contains($_SERVER['HTTP_ACCEPT_ENCODING'] ?? '', 'gzip')) {
    ob_start('ob_gzhandler'); // 內建 gzip 回調
} else {
    ob_start();
}

3. 錯誤頁面優雅降級

ob_start();
try {
    // 業務邏輯
    renderPage();
} catch (Exception $e) {
    ob_end_clean(); // 丟棄已輸出的內容
    http_response_code(500);
    include 'error_500.php';
}
ob_end_flush();

4. 異步輸出/長輪詢

ob_start();
for ($i = 1; $i <= 10; $i++) {
    echo "進度: $i%
"; ob_flush(); // 送到 SAPI flush(); // SAPI 送到瀏覽器 (需關閉 gzip、proxy_buffering) sleep(1); } ob_end_flush();

常見陷阱

  1. Header already sent:輸出前未開啟緩衝,或緩衝已刷新。解決:ob_start() 放在腳本最開頭。
  2. 巢狀未平衡:每個 ob_start() 必須配對 ob_end_flush() 或 ob_end_clean(),否則記憶體洩漏。
  3. 回調函式簽名:function callback(string $buffer, int $phase): string,$phase 含 PHP_OUTPUT_HANDLER_START 等旗標。
  4. CLI 模式:輸出緩衝預設關閉,需手動開啟。

php.ini 設定

output_buffering = 4096 ; 內建緩衝大小 (bytes),On=無限
; 開啟後所有腳本自動 ob_start(),但不建議依賴此設定

現代框架整合

  • Laravel: Response::capture()、View 渲染內部使用 ob
  • Symfony: HttpFoundation\Response 管理輸出
  • Yii: yii\web\Response 事件 EVENT_BEFORE_SEND
copyright © 萬盛學電腦網 all rights reserved