輸出控制函式讓 PHP 能攔截、緩存、修改腳本輸出,解決「Header already sent」、模板變數替換、靜態頁生成、錯誤捕獲等經典問題。本文系統梳理核心 API、工作流程、實戰模式與陷阱。
| 函式 | 作用 |
|---|---|
| ob_start(callable? $callback, int $chunk_size=0, bool $flags=PHP_OUTPUT_HANDLER_STDFLAGS) | 開啟緩衝,可選回調處理輸出 |
| ob_get_contents() | 取得緩衝區內容(字串) |
| ob_get_clean() | 取得內容並關閉緩衝(等同 get_contents + end_clean) |
| ob_end_flush() | 輸出緩衝區內容並關閉緩衝 |
| ob_end_clean() | 丟棄緩衝區內容並關閉緩衝 |
| ob_flush() | 刷新緩衝區到輸出(保持緩衝開啟) |
| ob_clean() | 清空緩衝區(保持緩衝開啟) |
| ob_get_level() | 巢狀緩衝層級 |
| ob_list_handlers() | 當前活躍的回調處理器列表 |
<?php
ob_start(); // 開啟緩衝,所有 echo 暫存
echo 'Hello';
header('Location: https://example.com'); // 正常工作
ob_end_flush(); // 送出
?>
<?php
ob_start();
include 'template.php'; // 模板中 echo 變數
$html = ob_get_clean(); // 取得渲染後 HTML
file_put_contents('cache/page.html', $html);
echo $html;
?>
<?php ob_start(); phpinfo(); $info = ob_get_clean(); // 含完整 HTML // 可進一步解析/儲存 ?>
<?php
function shutdownHandler(): void
{
$err = error_get_last();
if ($err && in_array($err['type'], [E_ERROR, E_PARSE, E_CORE_ERROR])) {
// 避免重複輸出
if (ob_get_level()) ob_end_clean();
http_response_code(500);
echo '系統錯誤
' . htmlspecialchars($err['message']) . '
';
}
}
register_shutdown_function('shutdownHandler');
ob_start(function($buffer) {
// 可在這裡做全局替換、壓縮、注入 CSRF token 等
return $buffer;
});
?>
<?php
function myCallback(string $buffer, int $phase): string
{
// $phase 位域:
// PHP_OUTPUT_HANDLER_START (1) - 首次啟動
// PHP_OUTPUT_HANDLER_CONT (2) - 中間刷新
// PHP_OUTPUT_HANDLER_END (4) - 最終關閉
// PHP_OUTPUT_HANDLER_CLEAN (8) - ob_clean()
// PHP_OUTPUT_HANDLER_FINAL (16) - 最終輸出
if ($phase & PHP_OUTPUT_HANDLER_START) {
// 可注入 等
}
if ($phase & PHP_OUTPUT_HANDLER_END) {
// 可附加 、埋點腳本
}
return str_replace('[TIME]', date('H:i:s'), $buffer); // 範例:替換佔位符
}
ob_start('myCallback');
echo 'Page generated at [TIME]';
ob_end_flush();
?>
掌握輸出控制,能優雅解決 Header 衝突、實現模板引擎、靜態化、錯誤頁、流式傳輸等核心功能。