萬盛學電腦網

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

PHP 彈出提示並重導向:JavaScript 與 Meta Refresh 多種實作比較

核心需求

在 PHP 處理完業務邏輯後,向使用者顯示訊息並自動跳轉新頁面。純 PHP header('Location: ...') 無法顯示提示,需結合前端技術。

方案一:JavaScript Alert + Location.href(最常用)

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 秒後跳轉

方案二:Meta Refresh(無 JavaScript 環境備援)

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 <<

方案三:PHP Header 重導向(無提示、效能最佳)

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);

方案四:現代化 SweetAlert2 / Toast 彈窗(優化 UX)

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;
}

關鍵注意事項

  1. 輸出緩衝:若啟用 output_buffering,header() 可在輸出後工作,但不保證所有環境生效。最佳實踐:重導向前絕無輸出。
  2. XSS 防護:所有動態輸入 JS 的字串必須用 json_encode() 配合 JSON_HEX_* 旗標編碼。
  3. 延遲跳轉:給使用者閱讀時間,建議 1-3 秒;關鍵操作(刪除、付款)建議需使用者確認按鈕。
  4. 降級策略:提供 `手動跳轉` 鏈接,應對 JS 被禁用或爬蟲場景。
  5. 狀態碼語義:POST 請求後重導 必須用 303,避免瀏覽器重新提交表單。

框架整合範例

Laravel

return redirect('/dashboard')->with('success', '操作成功!'); // Session 一次性訊息
// Blade 模板顯示
@if(session('success'))
    <script>Swal.fire({icon:'success',text:'{{ session('success') }}',timer:2000})</script>
@endif

ThinkPHP

// 控制器
$this->success('操作成功', url('index'));
// 或
$this->redirect('index', ['msg' => '操作成功']);

原生 PHP 封裝類

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。統一封裝工具函數,確保安全編碼與一致體驗。

copyright © 萬盛學電腦網 all rights reserved