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');
});
登入
= htmlspecialchars($_GET['error']) ?>
login($username, $password, $remember)) {
header('Location: dashboard.php');
exit;
} else {
header('Location: login.php?error=' . urlencode('帳號或密碼錯誤'));
exit;
}
autoLogin()) {
header('Location: login.php?redirect=' . urlencode($_SERVER['REQUEST_URI']));
exit;
}
$user = $auth->user();
?>
儀表板
歡迎, = htmlspecialchars($user['username']) ?> (= $user['role'] ?>)
check('post.delete')): ?>
你有刪除文章權限
logout();
header('Location: login.php');
exit;
; 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 標準。