Session(會話)是在伺服器端儲存使用者狀態資料的機制。瀏覽器端僅保存一個 session_id(通常透過 Cookie 傳遞),伺服器以此 ID 關聯儲存的資料。適用於登入狀態、購物車、權限控制等跨頁面資料共享。
| 函數 | 用途 | 備註 |
|---|---|---|
session_start() | 啟動/恢復會話 | 必須在任何輸出前呼叫 |
$_SESSION | 超全域陣列,讀寫會話資料 | PHP 4.1+ 推薦寫法 |
session_destroy() | 銷毀伺服器端會話資料 | 不會刪除瀏覽器 Cookie |
session_unset() | 釋放所有 $_SESSION 變數 | 配合 destroy 使用 |
session_regenerate_id() | 產生新 session_id(防 fixation) | 登入成功後必呼叫 |
session_id() | 取得/設定目前 session_id | 跨子域共享時用到 |
session_set_cookie_params() | 設定 Cookie 參數(有效期、路徑、域名、Secure、HttpOnly、SameSite) | 需在 session_start() 前呼叫 |
<?php
// 1. 啟動會話(放在腳本最頂端,任何輸出之前)
session_start();
// 2. 寫入會話資料
$_SESSION['user_id'] = 123;
$_SESSION['username'] = 'john_doe';
$_SESSION['permissions'] = ['read', 'write'];
// 3. 讀取會話資料
echo "歡迎,{$_SESSION['username']} (ID: {$_SESSION['user_id']})";
// 4. 檢查是否已登入
function isLoggedIn(): bool {
return isset($_SESSION['user_id']);
}
// 5. 修改會話資料
$_SESSION['last_activity'] = time();
// 6. 刪除特定會話變數
unset($_SESSION['temp_data']);
// 7. 登出:清空並銷毀
function logout(): void {
$_SESSION = [];
// 刪除客戶端 Cookie
if (ini_get('session.use_cookies')) {
$params = session_get_cookie_params();
setcookie(session_name(), '', time() - 42000,
$params['path'], $params['domain'],
$params['secure'], $params['httponly']
);
}
session_destroy();
}
?>
<?php
// 必須在 session_start() 之前設定
ini_set('session.cookie_httponly', '1'); // 防止 JS 存取 Cookie (XSS 防護)
ini_set('session.cookie_secure', '1'); // 僅 HTTPS 傳送 (正式環境必開)
ini_set('session.cookie_samesite', 'Strict'); // CSRF 防護 (Lax/Strict)
ini_set('session.use_strict_mode', '1'); // 拒絕未初始化的 session_id
ini_set('session.gc_maxlifetime', '1800'); // 伺服器端資料保留 30 分鐘
ini_set('session.gc_probability', '1');
ini_set('session.gc_divisor', '100'); // 1% 機率觸發 GC
// 設定 Cookie 參數(路徑、域名、Secure、HttpOnly、SameSite)
session_set_cookie_params([
'lifetime' => 1800, // 30 分鐘無操作過期
'path' => '/',
'domain' => '.example.com', // 共享給子域 (可選)
'secure' => true, // 僅 HTTPS
'httponly' => true, // 防 XSS
'samesite' => 'Strict', // CSRF 防護
]);
session_start();
?>
ini_set('session.save_handler', 'redis');
ini_set('session.save_path', 'tcp://127.0.0.1:6379');SessionHandlerInterface 自訂儲存到 MySQL/PostgreSQL| 問題 | 原因 | 解決 |
|---|---|---|
Warning: session_start(): Cannot send session cookie - headers already sent | session_start() 前有輸出(空白、BOM、echo) | 確保 session_start() 在檔案最開頭,無任何輸出 |
| Session 資料不見/隨機登出 | GC 過度清理、多伺服器未共享儲存、Cookie 參數錯誤 | 調整 gc_maxlifetime、改用 Redis、檢查 cookie_domain/path |
| 子域無法共享 Session | Cookie domain 未設為 .example.com | session_set_cookie_params(['domain' => '.example.com']) |
| Session Fixation 攻擊 | 攻擊者固定 session_id 誘導受害者使用 | 登入後呼叫 session_regenerate_id(true) |
<?php
class PdoSessionHandler implements SessionHandlerInterface
{
private PDO $pdo;
public function __construct(PDO $pdo) { $this->pdo = $pdo; }
public function open($savePath, $sessionName): bool { return true; }
public function close(): bool { return true; }
public function read($id): string|false {
$stmt = $this->pdo->prepare("SELECT data FROM sessions WHERE id = ? AND expiry > ?");
$stmt->execute([$id, time()]);
return $stmt->fetchColumn() ?: '';
}
public function write($id, $data): bool {
$expiry = time() + (int)ini_get('session.gc_maxlifetime');
$stmt = $this->pdo->prepare("
INSERT INTO sessions (id, data, expiry) VALUES (?, ?, ?)
ON DUPLICATE KEY UPDATE data = VALUES(data), expiry = VALUES(expiry)
");
return $stmt->execute([$id, $data, $expiry]);
}
public function destroy($id): bool {
$stmt = $this->pdo->prepare("DELETE FROM sessions WHERE id = ?");
return $stmt->execute([$id]);
}
public function gc($maxlifetime): int|false {
$stmt = $this->pdo->prepare("DELETE FROM sessions WHERE expiry < ?");
$stmt->execute([time()]);
return $stmt->rowCount();
}
}
// 註冊
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'user', 'pass');
$handler = new PdoSessionHandler($pdo);
session_set_save_handler($handler, true);
session_start();
?>
Session 是 PHP 維持狀態的核心機制。掌握 session_start()、$_SESSION、session_destroy() 基本操作,並落實 HttpOnly、Secure、SameSite、Regenerate ID、分散式儲存 等安全設定,即可建立健全的會話管理系統。