七種跳轉方式對比
| 方式 | 原理 | 優點 | 缺點 | 適用場景 |
| 1. Header(Location) | HTTP 302/301 重導向 | 最快、SEO 友好、無輸出限制 | 必須在**任何輸出前**呼叫 | 後端邏輯跳轉、登入檢查、API 重導 |
| 2. Header(Refresh) | HTTP Refresh 標頭 | 可延遲跳轉、無輸出限制 | 非標準、SEO 差 | 延遲提示頁面 |
| 3. Meta Refresh | HTML <meta http-equiv="refresh"> | 純前端、可延遲、可顯示倒數 | SEO 差、被瀏覽器攔截、無法傳 POST | 靜態頁、維護頁、倒數跳轉 |
| 4. JS location.href | JS 修改 location | 可攜帶複雜邏輯、AJAX 後跳轉 | 需 JS 支援、歷史記錄汙染 | AJAX 成功後、表單提交後 |
| 5. JS location.replace | JS 替換歷史記錄 | 不留歷史、無法返回 | 需 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']);
?>
= htmlspecialchars($flash['msg']) ?>
常見錯誤與解決
| 錯誤 | 原因 | 解決 |
| Cannot modify header information | header() 前有輸出(空白、echo、BOM) | 檢查檔案開頭、關閉輸出緩衝 `ob_start()` |
| 跳轉循環 | A->B->A 或條件判斷錯誤 | 檢查邏輯、加入跳轉計數限制 |
| POST 資料遺失 | 302 導致瀏覽器轉 GET | 用 307/308 保持方法,或 PRG 模式 |
| 中文 URL 亂碼 | 未 URL 編碼 | `urlencode()` 或 `rawurlencode()` |
| JS 跳轉被攔截 | 瀏覽器彈窗攔截器 | 用 `location.replace` 或使用者主動點擊觸發 |
最佳實踐清單
- ✅ **優先使用 `header('Location: ...')` + `exit`**
- ✅ 封裝 `redirect()` 函數統一管理、防開放重導向
- ✅ 表單提交採用 **PRG 模式** 防重複提交
- ✅ 永久遷移用 **301**,暫時用 **302/303**,API 保持方法用 **307/308**
- ✅ 輸出前檢查 `headers_sent()`,降級 JS/Meta 跳轉
- ✅ 重要跳轉記錄日誌(從哪來、到哪去、狀態碼)
- ✅ 避免在模板/視圖中直接跳轉,集中在控制器/中介層
跳轉看似簡單,但關係到 SEO、安全性、用戶體驗與架構整潔。統一封裝、語義化狀態碼、PRG 模式,是專業 PHP 開發的標準配置。
copyright ©
萬盛學電腦網 all rights reserved