PHP header() 跳轉失效？三大核心原因與四種解決方案

現象：明明寫了 header('Location: ...') 卻不跳轉

經典場景：調試時在 header() 前 echo $url;，結果導致跳轉完全失效，頁面只輸出 URL 字串。根本原因在於 HTTP 協議規定：Header 必須在 Body 之前發送，一旦有任何輸出（含空白、BOM、錯誤訊息），Header 通道即關閉。

三大核心失效原因

1. 語法錯誤：Location: url 中冒號後不可有空格，正確寫法 header('Location: https://example.com');
2. 前置輸出：
   • 檔案開頭的 UTF-8 BOM（Byte Order Mark）
   • <?php 前的空白行、HTML 標籤
   • include/require 的檔案結尾 ?> 後有空白/換行
   • 錯誤/警告訊息（Warning: Cannot modify header information）
3. Header 後代碼繼續執行：header() 不會 自動終止腳本，後續代碼仍會跑完，建議搭配 exit;。

四種解決方案（由輕到重）

方案一：啟用輸出緩衝（推薦，零改動代碼）

修改 php.ini：

output_buffering = 4096
; 或 On（內部預設 4096 bytes）

重啟 PHP-FPM/Apache。原理：PHP 將輸出先存入記憶體緩衝區，header() 仍可在緩衝區刷新前插入 Header。

方案二：代碼層手動開啟緩衝

<?php
ob_start(); // 腳本最開頭調用
// ... 任意邏輯、echo、include ...
header('Location: https://example.com');
ob_end_flush(); // 發送緩衝內容並關閉緩衝
exit;

適用於無法修改 php.ini 的虛擬主機、或需精確控制輸出時機的場景。

方案三：徹底消除前置輸出（治本）

• 所有 PHP 檔案統一使用 無 BOM 的 UTF-8 編碼儲存（VS Code/Notepad++/PhpStorm 可見右下角編碼選項）。
• 純 PHP 類別/函數檔 省略結尾 ?>，官方 PSR-12 亦建議如此，杜絕尾部空白輸出。
• error_reporting(E_ALL); ini_set('display_errors', '0'); 生產環境關閉錯誤顯示，改寫入日誌。

方案四：JavaScript / Meta 降級跳轉（最後手段）

<!-- 方案 A：Meta Refresh -->
<meta http-equiv="refresh" content="0;url=https://example.com">

<!-- 方案 B：JavaScript -->
<script>window.location.replace('https://example.com');</script>

缺點：需瀏覽器解析 HTML、JS 執行，較 Header 3xx 跳轉慢，且爬蟲可能不跟隨。僅在無法控制 Header 時使用。

最佳實踐檢查清單

<?php
// 1. 檔案頂部：無 BOM、無空白、無 HTML
declare(strict_types=1); // 可選，嚴格模式

// 2. 業務邏輯
$url = 'https://example.com/target';

// 3. 跳轉前：確認無任何 echo/print/var_dump
// 4. 發送 Header
header('Location: ' . $url, true, 302); // 明確狀態碼
// 5. 立即終止
exit;

常見誤區 Q&A

Q: ob_start() 會影響效能嗎？

A: 4KB 緩衝區極小，現代伺服器記憶體充足，效能損耗可忽略不計；反而能合併網路封包提升吞吐。

Q: 為何有時候不加 exit 也能跳轉？

A: 瀏覽器收到 302 後會立即請求新 URL，但伺服器端腳本仍在跑完，可能造成重複寫入 DB、發送郵件等副作用。

Q: header('Location: ...') 相對路徑可以嗎？

A: RFC 7231 要求絕對 URI，但主流瀏覽器兼容相對路徑。建議一律使用絕對 URL 避免歧義。