在 PHP 處理完業務邏輯後,向使用者顯示訊息並自動跳轉新頁面。純 PHP header('Location: ...') 無法顯示提示,需結合前端技術。
function alertRedirect(string $msg, string $url, int $delayMs = 0): never {
// 防止 XSS:對輸出進行 JavaScript 字串編碼
$safeMsg = json_encode($msg, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP);
$safeUrl = json_encode($url, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP);
echo << { window.location.href = $safeUrl; }, $delayMs);
</script>
HTML;
exit;
}
// 使用
alertRedirect('登入成功', '/dashboard', 1000); // 1 秒後跳轉
function metaRedirect(string $msg, string $url, int $delaySec = 0): never {
$safeMsg = htmlspecialchars($msg, ENT_QUOTES, 'UTF-8');
$safeUrl = htmlspecialchars($url, ENT_QUOTES, 'UTF-8');
echo <<
function headerRedirect(string $url, int $statusCode = 302): never {
// 確保尚未輸出任何內容
if (headers_sent($file, $line)) {
error_log("Header redirect failed: output started at $file:$line");
// 降級為 JS 重導
echo "";
exit;
}
http_response_code($statusCode);
header("Location: $url");
exit;
}
// 301 永久移動、302 臨時移動、303 See Other (POST 後重導)、307/308 保持方法
headerRedirect('/login', 302);
function sweetAlertRedirect(string $title, string $text, string $url, string $icon = 'success'): never {
$safeTitle = json_encode($title, JSON_HEX_TAG|JSON_HEX_APOS|JSON_HEX_QUOT|JSON_HEX_AMP);
$safeText = json_encode($text, JSON_HEX_TAG|JSON_HEX_APOS|JSON_HEX_QUOT|JSON_HEX_AMP);
$safeUrl = json_encode($url, JSON_HEX_TAG|JSON_HEX_APOS|JSON_HEX_QUOT|JSON_HEX_AMP);
$safeIcon = json_encode($icon);
echo << { window.location.href = $safeUrl; });
</script>
</body></html>
HTML;
exit;
}
output_buffering,header() 可在輸出後工作,但不保證所有環境生效。最佳實踐:重導向前絕無輸出。json_encode() 配合 JSON_HEX_* 旗標編碼。return redirect('/dashboard')->with('success', '操作成功!'); // Session 一次性訊息
// Blade 模板顯示
@if(session('success'))
<script>Swal.fire({icon:'success',text:'{{ session('success') }}',timer:2000})</script>
@endif
// 控制器
$this->success('操作成功', url('index'));
// 或
$this->redirect('index', ['msg' => '操作成功']);
class Response {
public static function redirectWithAlert(string $url, string $msg, int $delay = 1500): never {
// 檢測是否為 AJAX 請求
if (!empty($_SERVER['HTTP_X_REQUESTED_WITH']) &&
strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest') {
header('Content-Type: application/json');
echo json_encode(['code' => 200, 'msg' => $msg, 'redirect' => $url]);
exit;
}
// 普通請求
self::alertRedirect($msg, $url, $delay);
}
}
根據場景選擇:API/ AJAX 回傳 JSON + 前端路由跳轉;傳統表單提交用 header('Location:') + Session Flash 訊息;需即時彈窗用 JavaScript Alert/SweetAlert2;無 JS 環境用 Meta Refresh。統一封裝工具函數,確保安全編碼與一致體驗。