方法對照表
| 方法 | 代碼 | 適用場景 | 注意事項 |
| HTTP Header | header('Location: https://example.com'); exit; | 伺服端導向、登入後跳轉、POST-Redirect-GET | 必須在輸出任何內容前呼叫;建議搭配 exit 防止後續代碼執行 |
| HTML Meta Refresh | echo ''; | 需延遲跳轉、顯示提示訊息、Header 已送出無法用 header() | 可被瀏覽器禁用、SEO 不友善、延遲不可控 |
| JavaScript | echo ''; | AJAX 回應中跳轉、需客戶端邏輯判斷 | 依賴 JS 執行、可能被攔截、不利 SEO |
最佳實踐:封裝統一導向函數
<?php
function redirect(string $url, int $statusCode = 302): never
{
// 避免 Header 已送出
if (headers_sent($file, $line)) {
// 降級:JS 跳轉
echo "<script>location.href=" . json_encode($url) . ";</script>";
exit;
}
http_response_code($statusCode);
header('Location: ' . $url);
exit;
}
// 使用
redirect('/dashboard'); // 302 臨時
redirect('/login', 301); // 301 永久
redirect('/error?code=403', 403); // 自定狀態碼
?>
常見坑點
- BOM/空白輸出:檔案儲存為 UTF-8 without BOM,
<?php 前無任何字元。
- 相對路徑導向失效:建議使用絕對路徑
/path 或完整 URL。
- POST 後直接導向:實作 PRG 模式防止重複提交。