萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 頁面跳轉總結:Header、Meta、JavaScript 七種方式與最佳實踐

七種跳轉方式對比

方式原理優點缺點適用場景
1. Header(Location)HTTP 302/301 重導向最快、SEO 友好、無輸出限制必須在**任何輸出前**呼叫後端邏輯跳轉、登入檢查、API 重導
2. Header(Refresh)HTTP Refresh 標頭可延遲跳轉、無輸出限制非標準、SEO 差延遲提示頁面
3. Meta RefreshHTML <meta http-equiv="refresh">純前端、可延遲、可顯示倒數SEO 差、被瀏覽器攔截、無法傳 POST靜態頁、維護頁、倒數跳轉
4. JS location.hrefJS 修改 location可攜帶複雜邏輯、AJAX 後跳轉需 JS 支援、歷史記錄汙染AJAX 成功後、表單提交後
5. JS location.replaceJS 替換歷史記錄不留歷史、無法返回需 JS登入後跳轉、支付完成
6. JS window.open新視窗/分頁可控制目標視窗易被攔截、體驗差外部連結、檔案下載
7. HTTP 301/303/307/308語義化狀態碼SEO 最佳、快取行為明確需理解語義差異永久遷移、API 規範

核心實作:Header 跳轉(生產首選)

<?php
/**
 * 安全重導向函數
 * @param string $url 目標 URL
 * @param int $code HTTP 狀態碼:301/302/303/307/308
 * @param bool $exit 是否終止腳本
 */
function redirect(string $url, int $code = 302, bool $exit = true): never
{
    // 1. 防止開放重導向攻擊:驗證域名白名單
    $allowedHosts = ['example.com', 'www.example.com', 'api.example.com'];
    $parsed = parse_url($url);
    if ($parsed && isset($parsed['host']) && !in_array($parsed['host'], $allowedHosts, true)) {
        throw new InvalidArgumentException("Redirect to external host not allowed: {$parsed['host']}");
    }

    // 2. 確保無輸出
    if (headers_sent($file, $line)) {
        // 已有輸出:降級為 JS 跳轉
        fallbackJsRedirect($url);
        if ($exit) exit;
        return;
    }

    // 3. 發送標頭
    http_response_code($code);
    header("Location: $url", true, $code);
    
    // 4. 兼容舊瀏覽器
    header("Cache-Control: no-cache, must-revalidate");
    header("Expires: Sat, 26 Jul 1997 05:00:00 GMT");

    if ($exit) exit;
}

function fallbackJsRedirect(string $url): void
{
    echo "";
    echo "";
    echo "";
    echo "正在跳轉... 點這裡";
}

// 使用範例
// redirect('/dashboard');           // 302 暫時性
// redirect('/new-url', 301);        // 301 永久移動(SEO 傳遞權重)
// redirect('/api/v2/...', 307);     // 307 保持 POST 方法
?>

進階:PRG 模式(Post-Redirect-Get)

<?php
// 處理表單提交
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 1. 驗證 CSRF Token
    if (!hash_equals($_SESSION['csrf_token'] ?? '', $_POST['csrf_token'] ?? '')) {
        http_response_code(403);
        exit('CSRF token invalid');
    }

    // 2. 處理業務邏輯
    $result = processForm($_POST);

    // 3. 設定閃存訊息
    $_SESSION['flash'] = $result['success'] 
        ? ['type' => 'success', 'msg' => '操作成功']
        : ['type' => 'error', 'msg' => $result['error']];

    // 4. 重導向到 GET 頁面(防止重複提交)
    redirect('/form-page');
    exit;
}

// GET 請求:顯示頁面 + 閃存訊息
$flash = $_SESSION['flash'] ?? null;
unset($_SESSION['flash']);
?>




    

常見錯誤與解決

最佳實踐清單

  • ✅ **優先使用 `header('Location: ...')` + `exit`**
  • ✅ 封裝 `redirect()` 函數統一管理、防開放重導向
  • ✅ 表單提交採用 **PRG 模式** 防重複提交
  • ✅ 永久遷移用 **301**,暫時用 **302/303**,API 保持方法用 **307/308**
  • ✅ 輸出前檢查 `headers_sent()`,降級 JS/Meta 跳轉
  • ✅ 重要跳轉記錄日誌(從哪來、到哪去、狀態碼)
  • ✅ 避免在模板/視圖中直接跳轉,集中在控制器/中介層

跳轉看似簡單,但關係到 SEO、安全性、用戶體驗與架構整潔。統一封裝、語義化狀態碼、PRG 模式,是專業 PHP 開發的標準配置。

copyright © 萬盛學電腦網 all rights reserved
錯誤原因解決
Cannot modify header informationheader() 前有輸出(空白、echo、BOM)檢查檔案開頭、關閉輸出緩衝 `ob_start()`
跳轉循環A->B->A 或條件判斷錯誤檢查邏輯、加入跳轉計數限制
POST 資料遺失302 導致瀏覽器轉 GET用 307/308 保持方法,或 PRG 模式
中文 URL 亂碼未 URL 編碼`urlencode()` 或 `rawurlencode()`
JS 跳轉被攔截瀏覽器彈窗攔截器用 `location.replace` 或使用者主動點擊觸發