萬盛學電腦網

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

PHP Session 與 Cookie 實現「記住我」自動登錄完整方案

核心概念速覽

特性SessionCookie
存儲位置服務端(文件/Redis/DB)客戶端瀏覽器
生命周期瀏覽器關閉失效(預設)可設定過期時間(持久化)
容量較大(受服務端限制)4KB/域名,數量限制
安全性高(數據不暴露給客戶端)低(可被竄改、竊取、XSS)
主要用途用戶狀態、權限、購物車記住登錄、偏好設置、追蹤

Session 關鍵操作

<?php
// 必須在任何輸出前調用
session_start();

// 設置
$_SESSION['user_id'] = 123;
$_SESSION['username'] = 'zhangsan';
$_SESSION['roles'] = ['user', 'editor'];

// 讀取
$userId = $_SESSION['user_id'] ?? null;

// 刪除單項
unset($_SESSION['username']);

// 銷毀整個 Session(服務端文件 + 客戶端 Cookie)
session_destroy(); // 僅刪除服務端存儲
$_SESSION = [];    // 必須配合清空超全局變量

// 設置生命周期(預設 1440s=24min)
ini_set('session.gc_maxlifetime', 86400); // 1天
// 配合 cookie 生命周期
session_set_cookie_params(86400, '/', '', true, true); // Secure, HttpOnly
session_start();
?>

Cookie 關鍵操作

<?php
// 設置(必須在輸出前)
$expire = time() + 86400 * 30; // 30天
$path = '/';      // 全站可用
$domain = '';     // 當前域名
$secure = true;   // 僅 HTTPS 傳輸
$httponly = true; // 禁止 JS 訪問(防 XSS)

setcookie('remember_token', $token, $expire, $path, $domain, $secure, $httponly);

// 讀取
$token = $_COOKIE['remember_token'] ?? '';

// 刪除(設置過期時間為過去)
setcookie('remember_token', '', time() - 3600, $path, $domain, $secure, $httponly);

// 存儲陣列/對象:序列化 + Base64(防特殊字符)
$arr = ['uid' => 123, 'exp' => time() + 86400*30];
setcookie('auth_data', base64_encode(serialize($arr)), $expire, $path, $domain, $secure, $httponly);

// 讀取還原
$raw = $_COOKIE['auth_data'] ?? '';
$data = $raw ? unserialize(base64_decode($raw)) : null;
?>

自動登錄(「記住我」)完整流程

數據庫表設計

CREATE TABLE `user_tokens` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
  `user_id` BIGINT UNSIGNED NOT NULL,
  `selector` CHAR(24) NOT NULL,        -- 公開標識,用於查找
  `validator_hash` CHAR(64) NOT NULL,  -- 驗證器哈希(SHA-256)
  `expires` DATETIME NOT NULL,
  `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_selector` (`selector`),
  KEY `idx_user_expires` (`user_id`, `expires`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

登錄邏輯(含記住我)

<?php
// login.php
session_start();
require 'db.php';

$username = trim($_POST['username'] ?? '');
$password = $_POST['password'] ?? '';
$remember = isset($_POST['remember']); // checkbox

if (empty($username) || empty($password)) {
    die('用戶名密碼不能為空');
}

// 1. 驗證用戶(此處簡化,實際應用 password_verify)
$stmt = $pdo->prepare("SELECT id, password_hash FROM users WHERE username = ?");
$stmt->execute([$username]);
$user = $stmt->fetch();

if (!$user || !password_verify($password, $user['password_hash'])) {
    die('用戶名或密碼錯誤');
}

// 2. 建立 Session
$_SESSION['user_id'] = $user['id'];
$_SESSION['username'] = $username;
$_SESSION['login_time'] = time();

// 3. 若勾選「記住我」,生成持久 Token 存入 Cookie + DB
if ($remember) {
    $selector = bin2hex(random_bytes(12));      // 24 字符公開標識
    $validator = random_bytes(32);              // 32 字節高熵驗證器
    $validatorHash = hash('sha256', $validator); // 只存哈希

    $expires = new DateTime('+30 days');
    $stmt = $pdo->prepare("INSERT INTO user_tokens (user_id, selector, validator_hash, expires) VALUES (?, ?, ?, ?)");
    $stmt->execute([$user['id'], $selector, $validatorHash, $expires->format('Y-m-d H:i:s')]);

    // Cookie 存儲 selector:validator(Base64 編碼)
    $cookieVal = base64_encode("{$selector}:{$validator}");
    setcookie('remember_me', $cookieVal, $expires->getTimestamp(), '/', '', true, true);
}

// 4. 登錄成功跳轉
$redirect = $_GET['redirect'] ?? '/dashboard';
header("Location: {$redirect}");
exit;
?>

自動登錄檢查(每次請求入口執行)

<?php
// bootstrap.php / 公共入口
session_start();
require 'db.php';

function checkAutoLogin(): void {
    // 已有 Session 直接返回
    if (!empty($_SESSION['user_id'])) return;

    // 檢查 Cookie
    $cookie = $_COOKIE['remember_me'] ?? '';
    if (empty($cookie)) return;

    // 解析 selector:validator
    $decoded = base64_decode($cookie);
    if (!$decoded || strpos($decoded, ':') === false) return;
    [$selector, $validator] = explode(':', $decoded, 2);

    // 查找 Token(防時序攻擊用 prepared statement)
    $stmt = $pdo->prepare("SELECT user_id, validator_hash, expires FROM user_tokens WHERE selector = ?");
    $stmt->execute([$selector]);
    $token = $stmt->fetch();

    if (!$token) return; // Token 不存在

    // 檢查過期
    if (new DateTime($token['expires']) < new DateTime()) {
        $pdo->prepare("DELETE FROM user_tokens WHERE selector = ?")->execute([$selector]);
        return;
    }

    // 驗證 validator(恆定時間比較防時序攻擊)
    if (!hash_equals($token['validator_hash'], hash('sha256', $validator))) return;

    // 驗證通過:重建 Session
    $stmt = $pdo->prepare("SELECT username FROM users WHERE id = ?");
    $stmt->execute([$token['user_id']]);
    $user = $stmt->fetch();
    if (!$user) return;

    $_SESSION['user_id'] = $token['user_id'];
    $_SESSION['username'] = $user['username'];
    $_SESSION['auto_login'] = true;

    // 安全最佳實踐:使用後輪換 Token(刷新 selector/validator)
    $newSelector = bin2hex(random_bytes(12));
    $newValidator = random_bytes(32);
    $newHash = hash('sha256', $newValidator);
    $newExpires = new DateTime('+30 days');
    
    $pdo->prepare("UPDATE user_tokens SET selector=?, validator_hash=?, expires=? WHERE selector=?")
        ->execute([$newSelector, $newHash, $newExpires->format('Y-m-d H:i:s'), $selector]);
    
    setcookie('remember_me', base64_encode("{$newSelector}:{$newValidator}"), $newExpires->getTimestamp(), '/', '', true, true);
}

// 執行自動登錄檢查
checkAutoLogin();
?>

登出邏輯(清理雙端)

<?php
// logout.php
session_start();
require 'db.php';

// 1. 刪除服務端 Token(若為自動登錄)
if (!empty($_SESSION['auto_login']) && !empty($_COOKIE['remember_me'])) {
    $cookie = base64_decode($_COOKIE['remember_me']);
    if ($cookie && strpos($cookie, ':') !== false) {
        [$selector] = explode(':', $cookie, 2);
        $pdo->prepare("DELETE FROM user_tokens WHERE selector = ?")->execute([$selector]);
    }
}

// 2. 清除 Cookie
setcookie('remember_me', '', time() - 3600, '/', '', true, true);

// 3. 銷毀 Session
$_SESSION = [];
session_destroy();

// 4. 跳轉
header('Location: /login');
exit;
?>

安全最佳實踐清單

  1. HTTPS 強制:Secure 標誌確保 Cookie 僅在加密傳輸中發送。
  2. HttpOnly:防止 XSS 竊取 Cookie(document.cookie 無法讀取)。
  3. SameSite=Strict/Lax:防禦 CSRF(PHP 7.3+ session_set_cookie_params 支援)。
  4. Token 分離存儲:Cookie 存 selector:validator,數據庫只存 validator_hash,洩露資料庫也無法偽造 Cookie。
  5. 輪換機制:每次自動登錄成功刷新 Token,限制竊取 Token 的利用窗口。
  6. 定期清理過期 Token:Cron 任務清理 user_tokens 過期記錄。

總結

「記住我」本質是**長效憑證換取短效 Session**。核心模式:Cookie 存 selector:validator → DB 存 selector + validator_hash + expires → 驗證通過重建 Session + 輪換 Token。配合 HTTPS、HttpOnly、SameSite、資料庫唯一索引與定期清理,構建安全可用的自動登錄體系。

copyright © 萬盛學電腦網 all rights reserved