萬盛學電腦網

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

徹底解決表單重複提交:Token 驗證機制 PHP 完整實作

為何前端 JS 防重不夠?

JS 僅能阻擋「正常使用者」的重複點擊。攻擊者可繞過前端:

  • 直接對表單 action URL 發送 POST 請求 (curl/Postman/腳本)。
  • 停用 JavaScript 後提交。
  • 瀏覽器重整導致重複提交 (Post/Redirect/Get 模式可緩解)。

伺服器端 Token 驗證是唯一可靠防線。

Token 防重核心邏輯

  1. 生成 Token:表單渲染時,生成唯一隨機 Token 存入 Session,並寫入表單隱藏欄位。
  2. 驗證 Token:表單提交時,比對 $_POST['token'] 與 $_SESSION['form_token']。
  3. 一次性銷毀:驗證通過後立即 unset($_SESSION['form_token']),防止重放。
  4. 失敗處理:Token 缺失/不符 → 拒絕處理、顯示錯誤、重新生成 Token 讓用戶再試。

完整程式碼實作

1. 表單頁面 (form.php)

<?php
session_start();
// 生成 Token
$token = bin2hex(random_bytes(32)); // PHP 7+ 安全隨機
$_SESSION['form_token'] = $token;
?>
<!DOCTYPE html>
<html>
<head><meta charset="utf-8"><title>安全表單</title></head>
<body>
<form method="post" action="submit.php">
    <label>內容:<input type="text" name="data" required></label>
    <input type="hidden" name="token" value="<?php echo $token; ?>">
    <button type="submit">提交</button>
</form>
</body>
</html>

2. 處理頁面 (submit.php)

<?php
session_start();

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    header('Location: form.php');
    exit;
}

// 1. 檢查 Token 存在
if (empty($_POST['token']) || empty($_SESSION['form_token'])) {
    die('非法請求:Token 缺失,請重新提交表單。');
}

// 2. 驗證 Token (使用 hash_equals 防時序攻擊)
if (!hash_equals($_SESSION['form_token'], $_POST['token'])) {
    die('非法請求:Token 不匹配,疑似 CSRF 攻擊或重複提交。');
}

// 3. 驗證通過:銷毀 Token (一次性)
unset($_SESSION['form_token']);

// 4. 業務邏輯處理
$data = trim($_POST['data']);
// ... 資料庫寫入、發送郵件等 ...

// 5. PRG 模式:重導向避免重整重複提交
header('Location: success.php?msg=' . urlencode('提交成功!'));
exit;

3. 成功頁 (success.php)

<?php
echo htmlspecialchars($_GET['msg'] ?? '操作完成');
?>

進階:多表單並存的 Token 管理

同一頁面有多個表單 (如登入、註冊、搜尋),需區分 Token:

<?php
// 生成帶命名空間的 Token
function generate_form_token($form_name) {
    $token = bin2hex(random_bytes(32));
    $_SESSION['form_tokens'][$form_name] = $token;
    return $token;
}

function verify_form_token($form_name, $input_token) {
    if (empty($_SESSION['form_tokens'][$form_name]) || empty($input_token)) return false;
    $valid = hash_equals($_SESSION['form_tokens'][$form_name], $input_token);
    if ($valid) unset($_SESSION['form_tokens'][$form_name]); // 一次性
    return $valid;
}

// 使用
$login_token = generate_form_token('login');
$reg_token   = generate_form_token('register');

對比:其他防重方案優缺點

方案優點缺點推薦度
JS 禁用按鈕簡單、無伺服器負擔極易繞過、無安全性★ (僅輔助)
Post/Redirect/Get (PRG)解決重整重複、無狀態不防惡意重發、不防 CSRF★★★ (必做)
資料庫唯一索引資料層面絕對去重業務邏輯侵入性強、錯誤訊息不友善★★ (輔助)
Session Token (本文)防重複+防 CSRF、標準模式需 Session、分散式需共享 Session/Redis★★★★★ (核心)
JWT 無狀態 Token無 Session 依賴、微服務友善實現較複雜、需簽名驗證★★★★ (API 適用)

分散式系統中的 Token 共享

  • 將 Token 存入 Redis,Key:form_token:{form_name}:{session_id},TTL 30 分鐘。
  • 驗證時用 Lua 腳本 GETDEL 原子獲取並刪除,避免併發競態。

採用「伺服器端一次性 Token + PRG 跳轉」雙重保障,是解決表單重複提交的工業級標準方案。

copyright © 萬盛學電腦網 all rights reserved