You need to enable JavaScript to run this app. 现有PHP登录系统如何实现「记住我」Cookie功能
优惠活动
大模型
产品
解决方案
定价
更多

现有PHP登录系统如何实现「记住我」Cookie功能

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类中,补充三个关键流程:

  1. 登录成功时按用户勾选状态生成令牌、写入Cookie和数据库记录
  2. 原有Session登录态失效时,自动校验Cookie令牌恢复登录
  3. 登出时同步清除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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 01:36:04