萬盛學電腦網

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

PHP Cookie 記住登入狀態:三階段完整實現與安全加固指南

三階段架構

  1. 檢查登入狀態:Session 優先 → Cookie Token 回補 Session
  2. 處理登入提交:驗證帳密 → 建立 Session → 可選發行 Remember Token
  3. 處理登出:銷毀 Session → 撤銷 Cookie Token

階段一:統一登入檢查 auth_check.php

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

function checkLogin() {
    global $pdo;
    
    // 1. Session 有效直接返回
    if (!empty($_SESSION['user_id'])) {
        return $_SESSION['user_id'];
    }
    
    // 2. 嘗試從 Remember Token 恢復
    if (!empty($_COOKIE['remember_token'])) {
        $tokenData = @base64_decode($_COOKIE['remember_token']);
        if ($tokenData && strpos($tokenData, ':') !== false) {
            list($selector, $validator) = explode(':', $tokenData, 2);
            $selector = bin2hex($selector); // 確保格式
            
            $stmt = $pdo->prepare("
                SELECT user_id, validator_hash, expires_at 
                FROM user_tokens 
                WHERE selector = ? AND expires_at > NOW()
            ");
            $stmt->execute([$selector]);
            $token = $stmt->fetch();
            
            if ($token && hash_equals($token['validator_hash'], hash('sha256', $validator))) {
                // Token 有效,重建 Session
                $_SESSION['user_id'] = $token['user_id'];
                
                // 續期 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]);
                
                return $token['user_id'];
            }
        }
        // Token 無效,清除 Cookie
        setcookie('remember_token', '', time()-3600, '/', '', true, true);
    }
    
    return false;
}

// 使用:受保護頁面頂部引入
$userId = checkLogin();
if (!$userId) {
    header('Location: login.php?redirect=' . urlencode($_SERVER['REQUEST_URI']));
    exit;
}
// 此處 $user_id 可用,查詢用戶詳細資料
$stmt = $pdo->prepare("SELECT * FROM users WHERE id = ?");
$stmt->execute([$userId]);
$user = $stmt->fetch();

階段二:登入提交處理 login.php

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

$errors = [];
$redirect = $_GET['redirect'] ?? '/dashboard.php';

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $username = trim($_POST['username'] ?? '');
    $password = $_POST['password'] ?? '';
    $remember = !empty($_POST['remember']);
    $csrfToken = $_POST['csrf_token'] ?? '';
    
    // CSRF 驗證
    if (!hash_equals($_SESSION['csrf_token'] ?? '', $csrfToken)) {
        $errors[] = '無效的請求,請重新整理頁面';
    }
    
    // 基礎驗證
    if ($username === '' || $password === '') {
        $errors[] = '帳號與密碼不可為空';
    }
    
    if (empty($errors)) {
        $stmt = $pdo->prepare("SELECT id, password, status FROM users WHERE username = ?");
        $stmt->execute([$username]);
        $user = $stmt->fetch();
        
        if (!$user) {
            $errors[] = '帳號不存在';
        } elseif ($user['status'] !== 'active') {
            $errors[] = '帳號已停用';
        } elseif (!password_verify($password, $user['password'])) {
            $errors[] = '密碼錯誤';
        } else {
            // 登入成功
            session_regenerate_id(true); // 防 Session Fixation
            $_SESSION['user_id'] = $user['id'];
            $_SESSION['username'] = $username;
            $_SESSION['login_time'] = time();
            
            // 記錄登入日誌
            $pdo->prepare("INSERT INTO login_logs (user_id, ip, user_agent, success) VALUES (?, ?, ?, 1)")
                ->execute([$user['id'], $_SERVER['REMOTE_ADDR'], $_SERVER['HTTP_USER_AGENT'] ?? '']);
            
            // 簽發 Remember Token
            if ($remember) {
                $selector = random_bytes(16);
                $validator = random_bytes(32);
                $expires = date('Y-m-d H:i:s', time() + 30*86400);
                
                $pdo->prepare("INSERT INTO user_tokens (user_id, selector, validator_hash, expires_at) VALUES (?, ?, ?, ?)")
                    ->execute([$user['id'], bin2hex($selector), hash('sha256', $validator), $expires]);
                
                setcookie('remember_token', base64_encode($selector . ':' . $validator), [
                    'expires' => time() + 30*86400,
                    'path' => '/',
                    'secure' => true,
                    'httponly' => true,
                    'samesite' => 'Lax'
                ]);
            }
            
            header('Location: ' . $redirect);
            exit;
        }
    }
}

// 產生 CSRF Token
$_SESSION['csrf_token'] = bin2hex(random_bytes(32));
?>
<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>登入</title></head><body>
<form method="post">
    <input type="hidden" name="csrf_token" value="<?= htmlspecialchars($_SESSION['csrf_token']) ?>">
    <div><label>帳號: <input type="text" name="username" autocomplete="username" required></label></div>
    <div><label>密碼: <input type="password" name="password" autocomplete="current-password" required></label></div>
    <div><label><input type="checkbox" name="remember" value="1"> 記住我 (30天)</label></div>
    <button type="submit">登入</button>
</form>
<?php if ($errors): ?><ul style="color:red"><?php foreach($errors as $e): ?><li><?= $e ?></li><?php endforeach; ?></ul><?php endif; ?>
</body></html>

階段三:登出處理 logout.php

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

// 撤銷 Remember Token
if (!empty($_COOKIE['remember_token'])) {
    $tokenData = @base64_decode($_COOKIE['remember_token']);
    if ($tokenData && strpos($tokenData, ':') !== false) {
        list($selector) = explode(':', $tokenData, 2);
        $pdo->prepare("DELETE FROM user_tokens WHERE selector = ?")->execute([bin2hex($selector)]);
    }
    setcookie('remember_token', '', time()-3600, '/', '', true, true);
}

// 記錄登出日誌
if (!empty($_SESSION['user_id'])) {
    $pdo->prepare("INSERT INTO login_logs (user_id, ip, action) VALUES (?, ?, 'logout')")
        ->execute([$_SESSION['user_id'], $_SERVER['REMOTE_ADDR']]);
}

// 徹底銷毀 Session
$_SESSION = [];
if (ini_get("session.use_cookies")) {
    $params = session_get_cookie_params();
    setcookie(session_name(), '', time() - 42000, $params["path"], $params["domain"], $params["secure"], $params["httponly"]);
}
session_destroy();

header('Location: login.php');

簡潔版:單檔案演示(教學用)

<?php
session_start();
// 讀取 Cookie 預填
$ckUser = $_COOKIE['remember_user'] ?? '';
$ckPass = $_COOKIE['remember_pass'] ?? '';
$ckRemember = !empty($_COOKIE['remember_flag']);

if ($_POST['login']) {
    $u = $_POST['user']; $p = $_POST['pass']; $r = !empty($_POST['remember']);
    // 這裡應接資料庫驗證,示例直接判斷
    if ($u === 'admin' && $p === '123456') {
        $_SESSION['user'] = $u;
        if ($r) {
            setcookie('remember_user', $u, time()+30*86400, '/');
            setcookie('remember_pass', $p, time()+30*86400, '/'); // ⚠ 明文密碼!僅示例
            setcookie('remember_flag', '1', time()+30*86400, '/');
        } else {
            setcookie('remember_user', '', time()-3600, '/');
            setcookie('remember_pass', '', time()-3600, '/');
            setcookie('remember_flag', '', time()-3600, '/');
        }
        header('Location: dashboard.php');
    } else {
        $err = '帳密錯誤';
    }
}
?>
<form method="post">
    帳號: <input name="user" value="<?=htmlspecialchars($ckUser)?>"><br>
    密碼: <input type="password" name="pass" value="<?=htmlspecialchars($ckPass)?>"><br>
    <label><input type="checkbox" name="remember" <?=$ckRemember?'checked':''?>> 記住我</label><br>
    <button>登入</button>
</form>

安全對比總結

版本密碼存儲Token 機制適用場景
簡潔版明文 Cookie無本地測試、教學
三階段版資料庫 bcryptSelector+Validator 雜湊、滑動過期、設備綁定生產環境標準
企業級硬體加密模組/HSMJWT + 短期 Access Token + 長期 Refresh Token + 裝置指紋高安全需求、多系統 SSO

總結

PHP 實現記住登入狀態,核心在於Token 設計與Cookie 安全屬性。生產環境必須:

  • 資料庫存雜湊而非明文
  • Cookie 設置 HttpOnly+Secure+SameSite
  • 實現 Token 滑動過期與異常撤銷
  • 敏感操作(改密、綁定、支付)強制二次驗證
copyright © 萬盛學電腦網 all rights reserved