萬盛學電腦網

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

PHP Session 登入登出完整實作:驗證流程、安全防護、記住我與分散式擴展

前言

Session 是傳統 Web 認證的基石。本文提供生產級登入登出完整實作:密碼雜湊、防暴力破解、Session 安全配置、記住我 (長期 Token)、權限檢查中介層、分散式 Session 擴展。

一、資料庫結構

CREATE TABLE `users` (
    `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
    `username` VARCHAR(50) NOT NULL UNIQUE,
    `email` VARCHAR(100) NOT NULL UNIQUE,
    `password_hash` VARCHAR(255) NOT NULL, -- Argon2id
    `remember_token` VARCHAR(64) DEFAULT NULL UNIQUE, -- 記住我 Token
    `last_login_at` TIMESTAMP NULL,
    `failed_attempts` TINYINT UNSIGNED DEFAULT 0,
    `locked_until` TIMESTAMP NULL,
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `sessions` (
    `id` CHAR(40) NOT NULL PRIMARY KEY, -- Session ID
    `user_id` BIGINT UNSIGNED NULL,
    `data` BLOB NOT NULL,
    `expiry` INT UNSIGNED NOT NULL,
    INDEX `user_id` (`user_id`),
    INDEX `expiry` (`expiry`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

二、核心認證類

pdo = $pdo;
        // Session 安全配置
        ini_set('session.cookie_httponly', '1');
        ini_set('session.cookie_secure', '1'); // 僅 HTTPS
        ini_set('session.cookie_samesite', 'Lax');
        ini_set('session.use_strict_mode', '1');
        session_start();
    }
    
    // 登入
    public function login(string $username, string $password, bool $remember = false): bool {
        $stmt = $this->pdo->prepare("SELECT * FROM users WHERE username = ? OR email = ?");
        $stmt->execute([$username, $username]);
        $user = $stmt->fetch(PDO::FETCH_ASSOC);
        
        if (!$user) {
            $this->recordFailure($username);
            return false;
        }
        
        // 帳號鎖定檢查
        if ($user['locked_until'] && strtotime($user['locked_until']) > time()) {
            throw new Exception('帳號暫時鎖定,請稍後再試');
        }
        
        // 驗證密碼
        if (!password_verify($password, $user['password_hash'])) {
            $this->recordFailure($user['id']);
            return false;
        }
        
        // 登入成功
        $this->regenerateSession();
        $_SESSION['user_id'] = $user['id'];
        $_SESSION['username'] = $user['username'];
        $_SESSION['role'] = $user['role'] ?? 'user';
        $_SESSION['login_time'] = time();
        
        // 重置失敗計數
        $this->pdo->prepare("UPDATE users SET failed_attempts = 0, locked_until = NULL, last_login_at = NOW() WHERE id = ?")
            ->execute([$user['id']]);
        
        // 記住我
        if ($remember) {
            $this->issueRememberToken($user['id']);
        }
        
        return true;
    }
    
    // 記住我 Token
    private function issueRememberToken(int $userId): void {
        $token = bin2hex(random_bytes(32));
        $expiry = time() + 30 * 86400; // 30 天
        
        $this->pdo->prepare("UPDATE users SET remember_token = ? WHERE id = ?")
            ->execute([$token, $userId]);
        
        // 設定長效 Cookie (HttpOnly, Secure, SameSite)
        setcookie('remember_token', $token, $expiry, '/', '', true, true);
    }
    
    // 自動登入 (中介層呼叫)
    public function autoLogin(): bool {
        if (isset($_SESSION['user_id'])) return true; // 已有 Session
        
        $token = $_COOKIE['remember_token'] ?? '';
        if (!$token) return false;
        
        $stmt = $this->pdo->prepare("SELECT id, username, role FROM users WHERE remember_token = ?");
        $stmt->execute([$token]);
        $user = $stmt->fetch(PDO::FETCH_ASSOC);
        
        if ($user) {
            $this->regenerateSession();
            $_SESSION['user_id'] = $user['id'];
            $_SESSION['username'] = $user['username'];
            $_SESSION['role'] = $user['role'];
            return true;
        }
        return false;
    }
    
    // 登出
    public function logout(): void {
        // 清除記住我
        if (isset($_SESSION['user_id'])) {
            $this->pdo->prepare("UPDATE users SET remember_token = NULL WHERE id = ?")
                ->execute([$_SESSION['user_id']]);
            setcookie('remember_token', '', time() - 3600, '/', '', true, true);
        }
        
        // 銷毀 Session
        $_SESSION = [];
        session_destroy();
        
        // 刪除 Session Cookie
        $params = session_get_cookie_params();
        setcookie(session_name(), '', time() - 3600, $params['path'], $params['domain'], $params['secure'], $params['httponly']);
    }
    
    // 記錄失敗並鎖定
    private function recordFailure(string|int $identifier): void {
        $field = is_int($identifier) ? 'id' : 'username';
        $this->pdo->prepare("UPDATE users SET failed_attempts = failed_attempts + 1 WHERE $field = ?")
            ->execute([$identifier]);
        
        // 檢查是否達到鎖定閾值
        $stmt = $this->pdo->prepare("SELECT failed_attempts FROM users WHERE $field = ?");
        $stmt->execute([$identifier]);
        $attempts = $stmt->fetchColumn();
        
        if ($attempts >= $this->maxAttempts) {
            $lockUntil = date('Y-m-d H:i:s', time() + $this->lockoutTime);
            $this->pdo->prepare("UPDATE users SET locked_until = ? WHERE $field = ?")
                ->execute([$lockUntil, $identifier]);
        }
    }
    
    // 重生 Session ID (防 Session Fixation)
    private function regenerateSession(): void {
        session_regenerate_id(true); // 刪除舊檔案
    }
    
    // 獲取當前用戶
    public function user(): ?array {
        if (empty($_SESSION['user_id'])) return null;
        return [
            'id' => $_SESSION['user_id'],
            'username' => $_SESSION['username'],
            'role' => $_SESSION['role'],
        ];
    }
    
    // 權限檢查
    public function check(string $permission): bool {
        $user = $this->user();
        if (!$user) return false;
        // 這裡可對接 RBAC 系統
        return in_array($permission, $this->getPermissions($user['role']));
    }
    
    private function getPermissions(string $role): array {
        return match($role) {
            'admin' => ['*'],
            'editor' => ['post.create', 'post.edit', 'post.delete'],
            'user' => ['post.create'],
            default => [],
        };
    }
}

三、中介層保護路由

autoLogin()) {
            return $request->expectsJson() 
                ? response()->json(['error' => 'Unauthorized'], 401)
                : redirect()->route('login')->with('redirect', $request->fullUrl());
        }
        
        // 權限檢查
        foreach ($permissions as $perm) {
            if (!$auth->check($perm)) {
                return $request->expectsJson()
                    ? response()->json(['error' => 'Forbidden'], 403)
                    : abort(403);
            }
        }
        
        return $next($request);
    }
}

// 路由註冊
Route::group(['middleware' => [AuthMiddleware::class]], function() {
    Route::get('/dashboard', DashboardController::class);
    Route::resource('posts', PostController::class)->middleware('auth:post.edit,post.delete');
});

四、Session 資料庫驅動 (分散式就緒)

五、前端頁面範例

登入頁 (login.php)



登入

    
        

登入處理 (login_action.php)

login($username, $password, $remember)) {
    header('Location: dashboard.php');
    exit;
} else {
    header('Location: login.php?error=' . urlencode('帳號或密碼錯誤'));
    exit;
}

受保護頁面 (dashboard.php)

autoLogin()) {
    header('Location: login.php?redirect=' . urlencode($_SERVER['REQUEST_URI']));
    exit;
}

$user = $auth->user();
?>

儀表板

    

歡迎, ()

登出

check('post.delete')): ?>

你有刪除文章權限

登出 (logout.php)

logout();
header('Location: login.php');
exit;

六、安全加固清單

  • [ ] **密碼雜湊**:`password_hash($pwd, PASSWORD_ARGON2ID)` / `PASSWORD_BCRYPT`
  • [ ] **HTTPS 全站**:`session.cookie_secure = 1`
  • [ ] **HttpOnly Cookie**:`session.cookie_httponly = 1`
  • [ ] **SameSite Lax/Strict**:`session.cookie_samesite = 'Lax'`
  • [ ] **嚴格模式**:`session.use_strict_mode = 1`
  • [ ] **登入後重生 ID**:`session_regenerate_id(true)`
  • [ ] **暴力破解防護**:失敗計數 + 暫時鎖定 + CAPTCHA
  • [ ] **記住我 Token**:加密隨機、資料庫唯一索引、HttpOnly Secure Cookie、30天過期、使用後輪換
  • [ ] **敏感操作重新認證**:修改密碼、綁定手機、刪除帳號需重新輸入密碼
  • [ ] **Session 活動追蹤**:記錄 last_activity,閒置超時自動登出

七、分散式擴展:Redis Session

; php.ini
session.save_handler = redis
session.save_path = "tcp://redis-cluster:6379?prefix=session:&auth=pass&read_timeout=2&retry_interval=100"
session.gc_maxlifetime = 3600

或使用 Laravel/ThinkPHP 內建 Redis Session 驅動,支援 Cluster、Sentinel、自動故障轉移。

總結

完整的認證系統不只是「寫入 Session」,而是包含密碼雜湊、Session 安全配置、防暴力破解、記住我機制、權限體系、分散式儲存的工程體系。本文提供的 Auth 類可直接整合至任何 PHP 專案 (原生、Laravel、ThinkPHP、Symfony 等),並符合 OWASP Authentication Cheat Sheet 標準。

copyright © 萬盛學電腦網 all rights reserved