PHP 頁面跳轉三種方式：Header、Meta Refresh、JavaScript 完整對比

PHP 實現跳轉主要有三種機制：HTTP Header（服務端）、Meta Refresh（瀏覽器解析）、JavaScript（客戶端執行）。本文對比適用場景、參數細節、常見坑點與最佳實踐封裝。

方式一：Header Location（推薦、標準）

function redirect(string $url, int $code = 302): void {
    // 確保無輸出
    if (headers_sent($file, $line)) {
        trigger_error("Headers already sent in $file:$line", E_USER_WARNING);
        // 降級 JS 跳轉
        echo "";
        exit;
    }
    http_response_code($code);
    header("Location: $url", true, $code);
    exit; // 關鍵：阻止後續代碼執行
}

// 使用
redirect('/login.php', 302);        // 臨時跳轉
redirect('/new-url', 301);          // 永久跳轉 (SEO)
redirect('https://example.com');    // 跨域

• 優點：HTTP 標準、無客戶端依賴、SEO 友好（301/302）、可攜帶狀態碼；
• 鐵律：header() 前絕對不能有任何輸出（含空白、BOM、echo）；
• 注意：Location: 後無空格，header('Location:...') 大小寫不敏感；
• 執行流：header() 後代碼仍會執行，必須 exit。

方式二：Meta Refresh（兜底、延遲）

function meta_redirect(string $url, int $delay = 0): void {
    $url = htmlspecialchars($url, ENT_QUOTES, 'UTF-8');
    echo "";
    // 可選：顯示倒計時頁面
    if ($delay > 0) {
        echo "
{$delay} 秒後自動跳轉... 立即跳轉
";
    }
}

// 使用
meta_redirect('/dashboard.php', 3); // 3 秒後跳轉

• 優點：無需控制輸出緩衝、可延遲跳轉、靜態頁可用；
• 缺點：非 HTTP 標準、SEO 不友好、用戶可禁用、延遲不可控；
• 適用：輸出已開始無法 Header、靜態 HTML、提示頁面倒計時。

方式三：JavaScript location.href（客戶端、靈活）

function js_redirect(string $url, bool $replace = false): void {
    $url = addslashes($url);
    $method = $replace ? 'replace' : 'href';
    echo "";
    exit;
}

// 使用
js_redirect('/app.php');        // 記錄歷史
js_redirect('/app.php', true);  // replace：不記錄歷史，返回鍵不回跳轉頁

• 優點：可動態構建 URL、條件判斷跳轉、AJAX 回調中跳轉；
• 缺點：需 JS 啟用、可被攔截、SEO 無效；
• location.replace()：替換歷史記錄，避免「返回死循環」。

對比總結表

最佳實踐：統一跳轉類

class Redirect {
    public static function to(string $url, int $code = 302): never {
        if (!headers_sent()) {
            http_response_code($code);
            header("Location: $url", true, $code);
        } else {
            // 輸出已開始，降級
            self::js($url, true);
        }
        exit;
    }

    public static function js(string $url, bool $replace = false): never {
        $url = addslashes($url);
        $method = $replace ? 'replace' : 'href';
        echo "";
        exit;
    }

    public static function meta(string $url, int $delay = 0, string $msg = ''): never {
        $url = htmlspecialchars($url, ENT_QUOTES, 'UTF-8');
        echo "";
        if ($delay && $msg) echo "
$msg 立即跳轉
";
        exit;
    }

    // AJAX 統一返回
    public static function ajax(string $url, string $msg = '操作成功'): never {
        header('Content-Type: application/json');
        echo json_encode(['success' => true, 'message' => $msg, 'redirect' => $url]);
        exit;
    }
}

// 使用
Redirect::to('/login.php');
Redirect::ajax('/dashboard', '登入成功');

常見坑點避坑

1. BOM 頭導致 Header 失敗：編輯器保存為 UTF-8 無 BOM；
2. include/require 文件有空白行：關閉標籤 ?> 後無換行，或全文件省略 ?>；
3. Header 後忘記 exit：敏感邏輯繼續執行導致安全漏洞；
4. 相對路徑跳轉：Location: ./page.php 可能在某些代理下異常，建議絕對路徑 /page.php 或完整 URL；
5. 中文 URL 未編碼：JS/Location 中中文需 urlencode。

根據場景選擇正確跳轉方式，並封裝統一類，能消除 90% 的跳轉相關 Bug。