表單重複提交導致重複訂單、重複扣款、垃圾數據等嚴重問題。本文構建「前端攔截 + Token驗證 + PRG模式 + 數據庫唯一約束」四層防禦體系,並提供可復用的Trait組件。
303 Redirect到GET頁面,瀏覽器刷新不再重發POST。order_no)兜底防重。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;
}
}
}
// 簡單防抖指令
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 = '提交';
}
});
多層防禦是防重複提交的工程標準答案,單一手段皆有繞過風險。