萬盛學電腦網

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

PHP Cookie 設置、驗證與防重複提交實戰

Cookie 基礎設置

<?php
// 設置 5 分鐘過期的 Cookie
$expire = time() + 300; // 5 分鐘 = 300 秒
$string = 'user_action'; // 業務標識
$salt = 'random_salt_string'; // 密鑰,實際應用請用配置文件管理

$code = hash('sha256', $string . $expire . $salt); // 建議用 hash 替代 md5

setcookie('check_time', $expire, $expire, '/', '', true, true); // Secure + HttpOnly
setcookie('code', $code, $expire, '/', '', true, true);
?>

參數詳解

  • name:Cookie 名稱
  • value:值
  • expire:Unix 時間戳過期時間,0 表示會話結束
  • path:生效路徑,/ 表示全站
  • domain:生效域名,留空為當前域名
  • secure:僅 HTTPS 傳輸
  • httponly:禁止 JavaScript 訪問,防 XSS

驗證與防重複提交邏輯

<?php
// 驗證請求
$now = time();
$checkTime = $_COOKIE['check_time'] ?? 0;
$code = $_COOKIE['code'] ?? '';

if ($checkTime < $now) {
    die('Token 已過期,請重新獲取。');
}

$expectedCode = hash('sha256', $string . $checkTime . $salt);
if (!hash_equals($expectedCode, $code)) { // 定時比較,防時序攻擊
    die('Token 無效,請勿重複提交。');
}

// 驗證通過,執行業務邏輯
// ...

// 用戶操作完成後,可選:刪除 Cookie 防止同一 Token 再次使用
setcookie('check_time', '', time() - 3600, '/');
setcookie('code', '', time() - 3600, '/');
?>

進階:防重複提交完整方案(表單 Token)

上述方法僅防過期前重複提交,更通用的方案是表單令牌 (CSRF Token):

<?php
session_start();

// 生成 Token
function generateToken(): string {
    if (empty($_SESSION['csrf_tokens'])) {
        $_SESSION['csrf_tokens'] = [];
    }
    $token = bin2hex(random_bytes(32));
    $_SESSION['csrf_tokens'][$token] = time(); // 記錄創建時間
    // 清理 1 小時前的舊 Token
    $_SESSION['csrf_tokens'] = array_filter($_SESSION['csrf_tokens'], fn($t) => $t > time() - 3600);
    return $token;
}

// 驗證並消費 Token
function validateToken(string $token): bool {
    if (empty($_SESSION['csrf_tokens'][$token])) return false;
    unset($_SESSION['csrf_tokens'][$token]); // 一次性使用
    return true;
}

// 表單頁
$token = generateToken();
?>

JavaScript 端 Cookie 操作(輔助)

<script>
// 設置 Cookie (1 小時)
function setCookie(name, value, hours = 1) {
    const d = new Date();
    d.setTime(d.getTime() + hours * 3600 * 1000);
    document.cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)};expires=${d.toUTCString()};path=/;SameSite=Lax`;
}

// 讀取 Cookie
function getCookie(name) {
    const match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'));
    return match ? decodeURIComponent(match[2]) : null;
}

// 刪除 Cookie
function deleteCookie(name) {
    document.cookie = `${encodeURIComponent(name)}=;expires=Thu, 01 Jan 1970 00:00:00 GMT;path=/`;
}

// 示例
setCookie('user_pref', 'dark_mode');
console.log(getCookie('user_pref'));
// deleteCookie('user_pref');
</script>

安全最佳實踐清單

  • ✅ 關鍵 Cookie 必設置 HttpOnly、Secure (HTTPS 環境)、SameSite=Lax/Strict。
  • ✅ 敏感操作使用 CSRF Token,而非單純依賴 Cookie 時間戳。
  • ✅ 使用 hash_equals() 比較 Token,防時序攻擊。
  • ✅ 定期輪換加密鹽值 $salt,洩露後可失效舊 Token。
  • ❌ 不要在 Cookie 存儲明文密碼、用戶 ID 等敏感信息。

總結

Cookie 是無狀態 HTTP 維持狀態的基礎機制。正確設置屬性、結合服務端簽名驗證、配合 CSRF Token,能構建安全可靠的用戶會話與防重複提交體系。

copyright © 萬盛學電腦網 all rights reserved