PHP 網頁開發中常需將使用者導向其他頁面。本文詳細比較三種重導向方法的優缺點、適用場景與最佳實務。
使用 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; // 關鍵:停止後續腳本執行
}
?>
Location: 後建議加空格exit 或 die() 防止後續程式碼執行<?php
// 頁面開頭啟用輸出緩衝
ob_start();
// ... 大量 HTML 輸出 ...
// 某處需要重導向
if ($needRedirect) {
header("Location: {$url}");
ob_end_flush(); // 發送緩衝內容(雖然瀏覽器會忽略)
exit;
}
?>
透過 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 |
輸出 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>
| 比較項目 | Header() | Meta Refresh | JavaScript |
|---|---|---|---|
| 速度 | ⚡ 最快 | 🐢 有延遲 | ⚡ 快(需載入 JS) |
| SEO 友善度 | ✅ 301/302 標準 | ⚠️ 較差 | ⚠️ 視實作而定 |
| 可在輸出後使用 | ❌ 需配合 ob_start() | ✅ 可 | ✅ 可 |
| 攜帶 POST 資料 | ❌ 通常轉 GET | ❌ | ✅ 可用 form submit |
| 攜帶 Referrer | ✅ 通常保留 | ⚠️ 視瀏覽器 | ✅ 保留 |
| 適用情境 | 伺服器端邏輯導向 | 顯示訊息後導向 | 客戶端邏輯/AJAX |
header():標準、快速、SEO 友善exit:防止敏感邏輯繼續執行headers_sent() 檢測是否已送出 Header<?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); // 永久移動
?>