「記住我」功能本質:在用戶裝置存儲辨識憑證,下次訪問時自動換取 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'];
// 這裡應該重新驗證密碼...
}
?>
<?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 | 嘗試猜測 validator | 256-bit 隨機數空間極大;可加入速率限制 |
| Token 重放 | 竊取後在有效期內重複使用 | 滑動過期;敏感操作需重新驗證密碼;重要操作簽名 |
| Session Fixation | 攻擊者預設 Session ID | 登入後 session_regenerate_id(true) |
setcookie('remember_token', $value, [
'expires' => time() + 30*86400,
'path' => '/',
'domain' => '', // 當前域名,不設定允許子域共享時留空
'secure' => true, // 僅 HTTPS 傳輸
'httponly' => true, // JS 無法讀取 (防 XSS)
'samesite' => 'Strict' // 防 CSRF (Lax 允許導航跳轉)
]);
「記住我」安全實現核心三要素:
生產環境建議直接使用成熟方案:symfony/remember-me、laravel/framework 內建 Remember Me、firebase/php-jwt 實現 Stateless JWT 方案。