萬盛學電腦網

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

PHP 重導向三大方法完整比較:Header、Meta Refresh、JavaScript

前言

PHP 網頁開發中常需將使用者導向其他頁面。本文詳細比較三種重導向方法的優缺點、適用場景與最佳實務。

方法一:HTTP Header 重導向(推薦)

使用 header() 發送 HTTP 302/301 狀態碼,瀏覽器自動跳轉,速度最快、使用者無感知。

基本語法

<?php
$url = 'https://example.com/target-page';

if (isset($url)) {
    // 302 暫時重導向(預設)
    header("Location: {$url}");
    // 或明確指定 301 永久重導向
    // header("Location: {$url}", true, 301);
    exit; // 關鍵:停止後續腳本執行
}
?>

關鍵注意事項

  • 必須在任何輸出前呼叫(含空白、BOM、HTML 標籤)
  • Location: 後建議加空格
  • 務必加上 exit 或 die() 防止後續程式碼執行
  • 相對網址在 HTTP/1.1 允許,但建議使用絕對網址

進階:輸出緩衝配合使用

<?php
// 頁面開頭啟用輸出緩衝
ob_start();

// ... 大量 HTML 輸出 ...

// 某處需要重導向
if ($needRedirect) {
    header("Location: {$url}");
    ob_end_flush(); // 發送緩衝內容(雖然瀏覽器會忽略)
    exit;
}
?>

方法二:HTML Meta Refresh

透過 HTML `` 標籤延遲跳轉,適用於需顯示提示訊息的情境。

基本語法

<?php
$url = 'https://example.com/target-page';
$delay = 5; // 秒數

if (!isset($url)) {
    exit('沒有跳轉地址');
}
?>
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>頁面跳轉中...</title>
    <meta http-equiv="refresh" content="<?php echo $delay; ?>; url='<?php echo htmlspecialchars($url, ENT_QUOTES); ?>'">
</head>
<body>
    

<?php echo $delay; ?> 秒後自動跳轉至 <a href="<?php echo htmlspecialchars($url); ?>">目標頁面</a>...</p> </body> </html>

優缺點

優點缺點
可顯示過渡訊息/廣告延遲跳轉,使用者體驗較差
不受「輸出前」限制SEO 不友善(搜尋引擎可能不追蹤)
可在輸出 HTML 後決定部分瀏覽器可停用 meta refresh

方法三:JavaScript 重導向

輸出 JS 程式碼操作 window.location,適用於 AJAX 回應或需客戶端邏輯判斷的情況。

基本語法

<?php
$url = 'https://example.com/target-page';
?>
<!DOCTYPE html>
<html>
<head><meta charset="utf-8"></head>
<body>
    <script>
        // 方式一:直接跳轉(不保留歷史記錄)
        window.location.replace('<?php echo htmlspecialchars($url, ENT_QUOTES); ?>');
        
        // 方式二:一般跳轉(保留歷史,可按「上一頁」返回)
        // window.location.href = '...';
    </script>
    

正在跳轉...</p> </body> </html>

適用場景

  • AJAX 回應中需導向新頁
  • 需根據客戶端條件(螢幕寬度、Cookie、LocalStorage)決定導向
  • 單頁應用(SPA)路由切換

三大方法完整比較表

比較項目Header()Meta RefreshJavaScript
速度⚡ 最快🐢 有延遲⚡ 快(需載入 JS)
SEO 友善度✅ 301/302 標準⚠️ 較差⚠️ 視實作而定
可在輸出後使用❌ 需配合 ob_start()✅ 可✅ 可
攜帶 POST 資料❌ 通常轉 GET❌✅ 可用 form submit
攜帶 Referrer✅ 通常保留⚠️ 視瀏覽器✅ 保留
適用情境伺服器端邏輯導向顯示訊息後導向客戶端邏輯/AJAX

最佳實務建議

  1. 優先使用 header():標準、快速、SEO 友善
  2. 永遠加上 exit:防止敏感邏輯繼續執行
  3. 輸出前檢查:使用 headers_sent() 檢測是否已送出 Header
  4. 避免重導向循環:設定最大重導向次數或檢查目標 URL
  5. 記錄重導向日誌:便於除錯與分析流量

實用封裝函式

<?php
function redirect(string $url, int $statusCode = 302, bool $exit = true): void {
    // 驗證 URL 格式
    if (!filter_var($url, FILTER_VALIDATE_URL)) {
        throw new InvalidArgumentException('無效的 URL');
    }
    
    // 防止 Header 重複發送
    if (headers_sent($file, $line)) {
        error_log("Header 已在 {$file}:{$line} 送出,改用 JS 重導向");
        echo "<script>window.location.replace('" . htmlspecialchars($url, ENT_QUOTES) . "');</script>";
        if ($exit) exit;
        return;
    }
    
    // 發送正確狀態碼
    http_response_code($statusCode);
    header("Location: {$url}");
    
    if ($exit) exit;
}

// 使用範例
redirect('https://example.com/login', 302);
redirect('https://example.com/new-url', 301); // 永久移動
?>
copyright © 萬盛學電腦網 all rights reserved