现有PHP登录系统如何实现「记住我」Cookie功能
第一步:数据库层改造
现有users表需要补充2个和持久登录关联的字段,不直接在Cookie中存储明文用户ID/账号信息,使用独立的随机令牌做关联校验,执行如下SQL:
ALTER TABLE users ADD COLUMN remember_token VARCHAR(64) NULL UNIQUE COMMENT '自动登录随机令牌', ADD COLUMN remember_expires_at INT NULL COMMENT '令牌有效期时间戳', ADD INDEX idx_remember_token (remember_token);
安全提示:禁止直接在Cookie中存储明文用户ID、账号、密码信息,否则会存在极高的账号被盗风险。
第二步:Auth认证类核心逻辑补全
在现有封装登录、登出、权限校验逻辑的Auth类中,补充三个关键流程:
- 登录成功时按用户勾选状态生成令牌、写入Cookie和数据库记录
- 原有Session登录态失效时,自动校验Cookie令牌恢复登录
- 登出时同步清除Cookie和数据库中的关联令牌
登录分支改动
在现有账号密码校验通过、写入Session的逻辑后,追加记住我分支处理:
if (!empty($_POST['remember_me'])) { // 生成64位长度无规律随机令牌,无法被逆向猜测 $rememberToken = bin2hex(random_bytes(32)); // 令牌默认有效期30天(单位:秒) $expireTime = time() + 86400 * 30; // 将令牌和过期时间更新到对应用户的数据库记录 $this->userModel->updateRememberToken($user['id'], $rememberToken, $expireTime); // 写入Cookie,注意必须在页面任何输出前调用 setcookie( name: 'remember_login', value: $rememberToken, expires_or_options: $expireTime, path: '/', domain: '', secure: !empty($_SERVER['HTTPS']), // HTTPS站点自动开启仅HTTPS传输 httponly: true // 禁止前端JS读取,防XSS窃取 ); }
登录态校验逻辑补全
在Auth类统一的登录态校验方法开头,追加自动恢复逻辑:
public function checkLogin() { // 保留原有Session有效时的校验逻辑 if (!empty($_SESSION['user_id'])) { return $this->validateUserExist($_SESSION['user_id']); } // Session失效时,检查记住我Cookie if (!empty($_COOKIE['remember_login'])) { $token = trim($_COOKIE['remember_login']); // 从数据库查询匹配的、未过期的用户记录 $user = $this->userModel->getUserByRememberToken($token, time()); if ($user) { // 校验通过,重建Session登录态 $_SESSION['user_id'] = $user['id']; // 自动登录成功后轮换令牌,降低泄露后的风险 $newToken = bin2hex(random_bytes(32)); $newExpire = time() + 86400 * 30; $this->userModel->updateRememberToken($user['id'], $newToken, $newExpire); setcookie('remember_login', $newToken, $newExpire, '/', '', !empty($_SERVER['HTTPS']), true); return true; } // 令牌无效时直接清除无效Cookie setcookie('remember_login', '', time() - 3600, '/'); } // 保留原有未登录状态的返回逻辑 return false; }
登出逻辑补全
在现有销毁Session的登出方法中,追加清理逻辑:
public function logout() { // 保留原有Session销毁逻辑 session_destroy(); // 清除数据库中对应用户的令牌记录 if (!empty($_SESSION['user_id'])) { $this->userModel->updateRememberToken($_SESSION['user_id'], null, null); } // 清除端侧的记住我Cookie if (!empty($_COOKIE['remember_login'])) { setcookie('remember_login', '', time() - 3600, '/'); unset($_COOKIE['remember_login']); } }
第三步:用户管理类配套方法补全
在现有封装数据库操作的用户管理类中,补充两个被Auth类调用的方法:
// 更新用户关联的记住我令牌信息 public function updateRememberToken(int $userId, ?string $token, ?int $expireTime): bool { $stmt = $this->pdo->prepare("UPDATE users SET remember_token = ?, remember_expires_at = ? WHERE id = ?"); return $stmt->execute([$token, $expireTime, $userId]); } // 按有效令牌查询对应用户 public function getUserByRememberToken(string $token, int $currentTime): ?array { $stmt = $this->pdo->prepare("SELECT * FROM users WHERE remember_token = ? AND remember_expires_at > ? LIMIT 1"); $stmt->execute([$token, $currentTime]); return $stmt->fetch(PDO::FETCH_ASSOC) ?: null; }
第四步:前端登录表单补全
在现有登录表单的密码输入框、提交按钮之间,新增「记住我」复选框,字段名和后端判断逻辑保持一致:
<div class="form-item"> <label> <input type="checkbox" name="remember_me" value="1"> 30天内自动登录 </label> </div>
高频踩坑提醒
setcookie()必须在页面任何HTML、空白字符、echo输出之前调用,否则会触发header already sent警告,Cookie无法正常写入- Cookie必须配置
httponly属性,否则前端脚本可直接读取令牌,一旦站点存在XSS漏洞,令牌会被直接窃取 - 不要设置无过期时间的永久Cookie,最长30天的有效期足够平衡体验和账号安全
- 每次自动登录成功必须轮换令牌,哪怕令牌不慎泄露,用户下次访问时旧令牌就会自动失效
内容的提问来源于stack exchange,提问作者user14898108
相关产品推荐
相关产品推荐

