在 PHP 開發中,header("Location: ...") 是實現頁面重定向的核心手段。然而,許多開發者在使用時容易踩中「標頭已發送」錯誤,或忽略重定向後腳本繼續執行的隱患。本文將深入剖析這兩大核心問題,並提供標準化的解決方案與輸出緩衝控制技巧。
header() 函數要求在調用前,腳本不能有任何實際輸出(包括空白字符、HTML 標籤、echo/print 等)。一旦有輸出發生,PHP 會拋出 Cannot modify header information - headers already sent 錯誤。
輸出緩衡 將腳本的輸出暫存在伺服器端記憶體中,而非即時發送給瀏覽器。這讓你可以在邏輯判斷後,決定是輸出內容還是執行重定向。
ob_start():開啟輸出緩衝ob_end_clean():清空緩衝區並關閉緩衝(不輸出內容)ob_end_flush():輸出緩衝區內容並關閉緩衝ob_flush():刷新緩衝區內容到瀏覽器(保持緩衝開啟)ob_get_contents():獲取緩衝區當前內容ob_get_length():獲取緩衝區內容長度<?php
ob_start(); // 1. 在腳本最開頭啟用緩衝
// ... 業務邏輯、數據處理 ...
if ($need_redirect) {
ob_end_clean(); // 2. 清空緩衝,確保無殘留輸出
header("Location: target.php");
exit; // 3. 關鍵:立即終止腳本執行
}
// 正常頁面輸出流程
// ...
ob_end_flush(); // 可選,腳本結束會自動刷新
?>
exit許多開發者誤以為 header("Location: ...") 會像瀏覽器端的跳轉一樣立即停止腳本。實際上,PHP 會繼續執行後續代碼。雖然瀏覽器收到重定向標頭後不會渲染後續 HTML,但這些代碼仍會消耗伺服器資源,且若包含敏感操作(如資料庫寫入、日誌記錄)會帶來安全風險。抓包分析可見伺服器確實回傳了完整響應體。
鐵律: 重定向語句後必須緊跟 exit; 或 die();。
php.ini 全局啟用輸出緩衝若不想在每個檔案寫 ob_start(),可修改 php.ini:
output_buffering = On
; 或指定緩衝區大小(單位 bytes)
output_buffering = 4096
開啟後,PHP 會自動緩衝所有輸出,header() 可在腳本任何位置調用(只要緩衝區未滿溢)。但強烈建議在專案入口文件顯式調用 ob_start(),避免依賴伺服器配置導致遷移時行為不一致。
| 函數 | 說明 |
|---|---|
flush() | 刷新系統輸出緩衝(Web 伺服器層面),高效常用 |
ob_start() | 開啟 PHP 內部輸出緩衝,非標頭資訊暫存 |
ob_get_contents() | 返回內部緩衝區內容字串,未啟用時返回 FALSE |
ob_get_length() | 返回內部緩衝區長度,未啟用時返回 FALSE |
ob_end_flush() | 輸出緩衝內容並關閉緩衝 |
ob_end_clean() | 丟棄緩衝內容並關閉緩衝(不輸出) |
ob_implicit_flush() | 開啟/關閉絕對刷新,開啟後每次輸出直接發送,無需 flush() |
var_dump() 輸出並安全顯示var_dump() 直接輸出到瀏覽器,若變數包含 HTML 特殊字符(<, >)會被瀏覽器解析導致顯示異常。利用輸出緩衝可輕松捕獲並轉義:
<?php
ob_start();
var_dump($complex_var);
$output = ob_get_contents();
ob_end_clean();
echo '<pre>' . htmlspecialchars($output) . '</pre>';
// 此時 $output 為純字串,可存入模板、日誌或稍後輸出
?>
ob_start(),消除「標頭已發送」煩惱。ob_end_clean(); header(...); exit; 缺一不可。ob_get_contents() 捕獲輸出,實現模板引擎、日誌記錄、API 回應封裝等高級用法。掌握輸出緩衝機制,是從 PHP 初學者進階為健壯後端工程師的關鍵一步。