萬盛學電腦網

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

PHP Cookie 實現「記住我」功能:從基礎到安全最佳實踐

核心概念

「記住我」功能本質:在用戶裝置存儲辨識憑證,下次訪問時自動換取 Session,免去重複輸入帳密。關鍵在於憑證安全性與生命週期管理。

基礎版:直接存帳密(❌ 極度不安全,僅教學)

<?php
// login.php
if ($_POST['login']) {
    $user = $_POST['user'];
    $pass = $_POST['pass'];
    $remember = !empty($_POST['remember']);
    
    // 驗證邏輯...
    if ($valid) {
        if ($remember) {
            // ⚠ 明文存密碼!絕不可用於生產
            setcookie('remember_user', $user, time() + 30*86400, '/');
            setcookie('remember_pass', $pass, time() + 30*86400, '/');
        }
        $_SESSION['user'] = $user;
        header('Location: dashboard.php');
    }
}

// 頁面載入時自動登入
if (empty($_SESSION['user']) && isset($_COOKIE['remember_user'])) {
    $_SESSION['user'] = $_COOKIE['remember_user'];
    // 這裡應該重新驗證密碼...
}
?>

進階版:Token 機制(推薦最小可行方案)

<?php
// config.php
session_start();
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
]);

// 資料表:user_tokens (user_id, selector, validator_hash, expires_at, user_agent, ip)

// 登入處理 login.php
require 'config.php';
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $username = trim($_POST['username'] ?? '');
    $password = $_POST['password'] ?? '';
    $remember = !empty($_POST['remember']);
    
    $stmt = $pdo->prepare("SELECT id, password FROM users WHERE username = ?");
    $stmt->execute([$username]);
    $user = $stmt->fetch();
    
    if ($user && password_verify($password, $user['password'])) {
        // 登入成功,建立 Session
        $_SESSION['user_id'] = $user['id'];
        $_SESSION['username'] = $username;
        
        if ($remember) {
            // 生成雙重 Token:selector (查找用) + validator (驗證用)
            $selector = bin2hex(random_bytes(16)); // 公開標識
            $validator = bin2hex(random_bytes(32)); // 祕密驗證碼
            
            $expires = new DateTime('+30 days');
            $hash = hash('sha256', $validator); // 資料庫只存雜湊
            
            $pdo->prepare("INSERT INTO user_tokens (user_id, selector, validator_hash, expires_at, user_agent, ip) 
                VALUES (?, ?, ?, ?, ?, ?)")
                ->execute([
                    $user['id'], $selector, $hash, 
                    $expires->format('Y-m-d H:i:s'),
                    $_SERVER['HTTP_USER_AGENT'] ?? '',
                    $_SERVER['REMOTE_ADDR']
                ]);
            
            // Cookie 存 selector:validator (Base64 編碼避免特殊字符)
            $cookieValue = base64_encode($selector . ':' . $validator);
            setcookie('remember_token', $cookieValue, $expires->getTimestamp(), '/', '', true, true);
        }
        
        header('Location: dashboard.php');
        exit;
    }
    $error = '帳號或密碼錯誤';
}

// 自動登入檢查(放在所有受保護頁面頂部或統一入口)
if (empty($_SESSION['user_id']) && !empty($_COOKIE['remember_token'])) {
    $cookieValue = base64_decode($_COOKIE['remember_token']);
    list($selector, $validator) = explode(':', $cookieValue, 2);
    
    $stmt = $pdo->prepare("SELECT user_id, validator_hash, expires_at FROM user_tokens WHERE selector = ?");
    $stmt->execute([$selector]);
    $token = $stmt->fetch();
    
    if ($token && $token['expires_at'] > date('Y-m-d H:i:s') 
        && hash_equals($token['validator_hash'], hash('sha256', $validator))) {
        
        // Token 有效,建立 Session
        $stmt = $pdo->prepare("SELECT username FROM users WHERE id = ?");
        $stmt->execute([$token['user_id']]);
        $user = $stmt->fetch();
        
        $_SESSION['user_id'] = $token['user_id'];
        $_SESSION['username'] = $user['username'];
        
        // 滑動過期:延長 Token 壽命
        $newExpire = date('Y-m-d H:i:s', time() + 30*86400);
        $pdo->prepare("UPDATE user_tokens SET expires_at = ? WHERE selector = ?")
            ->execute([$newExpire, $selector]);
    } else {
        // Token 無效/過期,清除 Cookie
        setcookie('remember_token', '', time()-3600, '/', '', true, true);
    }
}
?>

資料庫結構

CREATE TABLE `user_tokens` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
  `user_id` INT UNSIGNED NOT NULL,
  `selector` CHAR(32) NOT NULL,           -- 16 bytes hex
  `validator_hash` CHAR(64) NOT NULL,     -- sha256 hex
  `expires_at` DATETIME NOT NULL,
  `user_agent` VARCHAR(255) DEFAULT '',
  `ip` VARCHAR(45) DEFAULT '',
  `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_selector` (`selector`),
  KEY `idx_user_expires` (`user_id`, `expires_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

登出與撤銷

<?php
// logout.php
require 'config.php';

// 刪除當前 Token
if (!empty($_COOKIE['remember_token'])) {
    $cookieValue = base64_decode($_COOKIE['remember_token']);
    list($selector) = explode(':', $cookieValue, 2);
    $pdo->prepare("DELETE FROM user_tokens WHERE selector = ?")->execute([$selector]);
    setcookie('remember_token', '', time()-3600, '/', '', true, true);
}

// 刪除該用戶所有 Token(全裝置登出)
// $pdo->prepare("DELETE FROM user_tokens WHERE user_id = ?")->execute([$_SESSION['user_id']]);

session_unset();
session_destroy();
header('Location: login.php');

安全性深度解析

威脅風險對策
Cookie 竊取 (XSS/中間人)攻擊者獲取完整 Token 冒充用戶HttpOnly + Secure + SameSite=Strict;selector/validator 分離,資料庫只存 validator 雜湊
資料庫洩露獲得所有 validator_hash雜湊不可逆;selector 不敏感;可加入 user_agent/ip 綁定二次驗證
暴力破解 Token嘗試猜測 validator256-bit 隨機數空間極大;可加入速率限制
Token 重放竊取後在有效期內重複使用滑動過期;敏感操作需重新驗證密碼;重要操作簽名
Session Fixation攻擊者預設 Session ID登入後 session_regenerate_id(true)

Cookie 設定最佳實踐

setcookie('remember_token', $value, [
    'expires' => time() + 30*86400,
    'path' => '/',
    'domain' => '', // 當前域名,不設定允許子域共享時留空
    'secure' => true,     // 僅 HTTPS 傳輸
    'httponly' => true,   // JS 無法讀取 (防 XSS)
    'samesite' => 'Strict' // 防 CSRF (Lax 允許導航跳轉)
]);

總結

「記住我」安全實現核心三要素:

  1. 雙重 Token:Selector (查詢) + Validator (驗證),資料庫只存 Validator 雜湊
  2. Cookie 硬化:HttpOnly、Secure、SameSite=Strict、Base64 編碼
  3. 生命週期控制:滑動過期、異常撤銷、敏感操作重新驗證

生產環境建議直接使用成熟方案:symfony/remember-me、laravel/framework 內建 Remember Me、firebase/php-jwt 實現 Stateless JWT 方案。

copyright © 萬盛學電腦網 all rights reserved