萬盛學電腦網

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

PHP防止表單重複提交:Token令牌、PRG模式、前端攔截多層防禦體系

表單重複提交導致重複訂單、重複扣款、垃圾數據等嚴重問題。本文構建「前端攔截 + Token驗證 + PRG模式 + 數據庫唯一約束」四層防禦體系,並提供可復用的Trait組件。

四層防禦架構

  1. 前端攔截:提交後禁用按鈕、表單鎖定、防抖動。
  2. Token令牌(核心):服務端生成一次性Token,表單隱藏域攜帶,提交驗證後銷毀。
  3. PRG模式:POST處理後303 Redirect到GET頁面,瀏覽器刷新不再重發POST。
  4. 業務唯一鍵:資料庫唯一索引(如order_no)兜底防重。

Token實現(可復用Trait)

trait CsrfTokenTrait {
    private const TOKEN_KEY = '_csrf_tokens'; // 存儲多個Token支持多標籤頁
    private const TOKEN_TTL = 3600; // 1小時

    protected function generateToken(string $formName = 'default'): string {
        $token = bin2hex(random_bytes(32));
        $tokens = $_SESSION[self::TOKEN_KEY][$formName] ?? [];
        $tokens[$token] = time() + self::TOKEN_TTL;
        $_SESSION[self::TOKEN_KEY][$formName] = $tokens;
        return $token;
    }

    protected function validateToken(string $token, string $formName = 'default'): bool {
        $tokens = $_SESSION[self::TOKEN_KEY][$formName] ?? [];
        if (!isset($tokens[$token])) return false;
        if ($tokens[$token] < time()) {
            unset($tokens[$token]);
            return false;
        }
        unset($tokens[$token]); // 一次性使用
        $_SESSION[self::TOKEN_KEY][$formName] = $tokens;
        return true;
    }

    protected function cleanExpiredTokens(): void {
        foreach ($_SESSION[self::TOKEN_KEY] ?? [] as $formName => $tokens) {
            $_SESSION[self::TOKEN_KEY][$formName] = array_filter($tokens, fn($exp) => $exp > time());
        }
    }
}

控制器使用示例

class OrderController {
    use CsrfTokenTrait;
    public function create(): void {
        if ($_SERVER['REQUEST_METHOD'] === 'GET') {
            $token = $this->generateToken('order_create');
            include 'order_form.php'; // 表單中 
            return;
        }
        // POST處理
        $this->cleanExpiredTokens();
        if (!$this->validateToken($_POST['csrf_token'] ?? '', 'order_create')) {
            http_response_code(400);
            exit('無效或過期的表單提交,請刷新頁面重試');
        }
        // 業務邏輯:創建訂單(數據庫唯一索引兜底)
        try {
            $orderNo = $this->orderService->create($_POST);
            // PRG:重定向到成功頁,防刷新重複提交
            header('Location: /order/success?no=' . urlencode($orderNo));
            exit;
        } catch (PDOException $e) {
            if ($e->getCode() === '23000') { // 唯一鍵衝突
                exit('訂單已存在,請勿重複提交');
            }
            throw $e;
        }
    }
}

前端增強(Vue/React/原生JS)

// 簡單防抖指令
let submitting = false;
form.addEventListener('submit', async (e) => {
    if (submitting) return e.preventDefault();
    submitting = true;
    submitBtn.disabled = true;
    submitBtn.textContent = '提交中...';
    try {
        await fetch(form.action, {method: 'POST', body: new FormData(form)});
        // 成功後由服務端重定向
    } catch {
        submitting = false;
        submitBtn.disabled = false;
        submitBtn.textContent = '提交';
    }
});

常見誤區

  • 僅靠JS攔截:用戶可禁用JS、直接curl提交。
  • Token存單值:多標籤頁操作會互相踢出,應存儲Token集合(如上Trait)。
  • 未設置Token過期:導致Session膨脹、安全風險。
  • PRG重定向丟失POST數據:重定向前需將提示信息存入Session/Flash數據。

多層防禦是防重複提交的工程標準答案,單一手段皆有繞過風險。

copyright © 萬盛學電腦網 all rights reserved