前言

PHP 輸出控制函數 (Output Control Functions) 允許我們攔截、緩衝、操作腳本的輸出內容。這在「輸出內容後仍需發送 HTTP Header」、「頁面靜態化快取」、「錯誤頁面友善化」等場景極為關鍵。本文系統整理核心函數、運作機制與四大實戰案例。

核心函數速查表

運作原理

1. 呼叫 ob_start() 後，所有非 Header 的輸出 (echo, print, HTML 區塊) 會被導向內部緩衝區。
2. 緩衝區內容可被回呼函數 (callback) 轉換、過濾、壓縮 (如 ob_gzhandler)。
3. 腳本結束或呼叫 ob_end_flush() 時，緩衝內容才會真正送達瀏覽器。

四大實戰案例

案例 1：解決「Header already sent」錯誤

在輸出內容 之前 開啟緩衝，即可在任意位置呼叫 header()、setcookie()、session_start()。

<?php
ob_start(); // 必須在任何輸出前
echo 'Hello World'; // 此輸出被緩衝
header('Location: https://example.com'); // 正常運作
?>

案例 2：擷取輸出寫入靜態快取檔

ob_start();
// 大量運算、資料庫查詢、模板渲染...
$content = ob_get_contents();
ob_end_clean();

file_put_contents('cache/page.html', $content);
echo $content; // 直接輸出

案例 3：擷取無回傳值函數的輸出 (如 phpinfo)

ob_start();
phpinfo();
$info_html = ob_get_contents();
ob_end_clean();

// 現在 $info_html 可存入資料庫、發送 Email、或篩選敏感資訊後再輸出
echo $info_html;

案例 4：自訂錯誤處理與友善輸出

function my_error_handler($errno, $errstr, $errfile, $errline) {
    // 只處理非致命錯誤
    if (!(error_reporting() & $errno)) return false;
    
    $msg = "[$errno] $errstr in $errfile:$errline";
    error_log($msg); // 寫入系統日誌
    
    // 若在緩衝中，可直接輸出友善頁面
    if (ob_get_level() > 0) {
        ob_clean();
        echo "
系統暫時異常，請稍後再試
";
        echo "
錯誤代碼: $errno
";
        ob_end_flush();
        exit(1);
    }
    return true; // 讓內建處理器繼續
}

set_error_handler('my_error_handler');
ob_start(); // 開啟緩衡以便攔截
// ... 應用程式邏輯 ...
ob_end_flush();

進階：回呼函數 (Callback) 應用

function compress_html($buffer) {
    // 移除註解
    $buffer = preg_replace('/<!--.*?-->/s', '', $buffer);
    // 壓縮空白
    $buffer = preg_replace('/\s+/', ' ', $buffer);
    return $buffer;
}

ob_start('compress_html');
// 輸出大量 HTML...
ob_end_flush(); // 瀏覽器收到已壓縮的 HTML

常見坑與注意事項

• 巢狀緩衝：可多次呼叫 ob_start()，形成堆疊。ob_get_level() 回傳目前層級。
• 回呼函數限制：回呼內 不可 呼叫 ob_end_clean()、ob_flush() 等結束函數，否則行為未定義。
• chunk_size 參數：指定緩衝區達到多少位元組自動刷新，配合 ob_gzhandler 可實現分塊壓縮傳輸。
• flags 參數 (PHP 5.4+)：PHP_OUTPUT_HANDLER_CLEANABLE、PHP_OUTPUT_HANDLER_FLUSHABLE、PHP_OUTPUT_HANDLER_REMOVABLE 控制緩衝區可被清理/刷新/移除。

結語

輸出控制是 PHP 進階開發的基石技能。掌握緩衝機制、回呼處理、巢狀管理，能解決 Header 衝突、實現頁面快取、優化前端傳輸、統一錯誤呈現等關鍵需求。