Session 是伺服器端維持用戶狀態的核心機制。PHP 內建 Session 處理器將資料序列化儲存(預設檔案系統),透過 Cookie 傳遞 Session ID。本文完整涵蓋啟動、讀寫、銷毀、安全配置、自定義儲存處理器與分散式擴展。
Session 基本運作流程
session_start():啟動/恢復會話,發送 Set-Cookie: PHPSESSID=...
- 讀取/寫入
$_SESSION 超全域陣列
- 腳本結束時自動序列化儲存(或手動
session_write_close())
- 用戶瀏覽器攜帶 Session ID 進行後續請求
核心 API 操作
啟動會話(必須在輸出前)
<?php
// 建議在啟動前配置選項 (PHP 7.0+)
session_set_cookie_params([
'lifetime' => 3600, // 1 小時
'path' => '/',
'domain' => '.example.com',
'secure' => true, // 僅 HTTPS
'httponly' => true, // 防 XSS
'samesite' => 'Lax', // CSRF 保護
]);
session_start(); // 必須在任何輸出之前
?>
讀寫 Session 資料
<?php
session_start();
// 寫入
$_SESSION['user_id'] = 12345;
$_SESSION['username'] = 'john_doe';
$_SESSION['permissions'] = ['read', 'write'];
$_SESSION['cart'] = [
['product_id' => 1, 'qty' => 2],
['product_id' => 5, 'qty' => 1],
];
// 讀取
$userId = $_SESSION['user_id'] ?? null;
$cartCount = count($_SESSION['cart'] ?? []);
// 修改
$_SESSION['last_activity'] = time();
// 檢查是否登入
function isLoggedIn(): bool {
return isset($_SESSION['user_id']);
}
?>
銷毀會話
<?php
session_start();
// 刪除特定變數
unset($_SESSION['cart']);
// 完全銷毀會話(登出流程)
$_SESSION = []; // 清空所有會話變數
// 刪除 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 資料
session_destroy();
// 重新產生 Session ID (防 Session Fixation)
session_regenerate_id(true);
?>
Session 設定參數 (php.ini / ini_set)
| 參數 | 預設值 | 建議值 | 說明 |
session.save_handler | files | files/redis/memcached | 儲存處理器 |
session.save_path | /tmp | /var/lib/php/sessions | 儲存路徑(需寫入權限) |
session.gc_maxlifetime | 1440 (24分) | 3600 (1小時) 或更長 | 資料存活秒數,GC 機率清理 |
session.gc_probability | 1 | 1 | GC 機率分子 |
session.gc_divisor | 1000 | 1000 | GC 機率分母 (1/1000) |
session.cookie_lifetime | 0 | 0 (瀏覽器關閉過期) | Cookie 存活秒數,0=Session |
session.cookie_httponly | Off | On | 防 JS 存取 |
session.cookie_secure | Off | On (HTTPS 環境) | 僅 HTTPS 傳輸 |
session.cookie_samesite | "" | Lax | Lax/Strict/None |
session.use_strict_mode | Off | On | 拒絕未初始化的 Session ID |
session.sid_length | 32 | 48+ | Session ID 長度 |
session.sid_bits_per_character | 4 | 5 或 6 | ID 字元編碼位數 |
安全強化配置
<?php
// bootstrap/app.php 或啟動檔案最頂端
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);
ini_set('session.sid_length', 48);
ini_set('session.sid_bits_per_character', 6);
// 自定義儲存路徑 (避免共享主機 /tmp 衝突)
ini_set('session.save_path', __DIR__ . '/../storage/sessions');
// 定期重新生成 ID (防 Session Hijacking)
if (!isset($_SESSION['last_regenerate']) || time() - $_SESSION['last_regenerate'] > 300) {
session_regenerate_id(true);
$_SESSION['last_regenerate'] = time();
}
session_start();
?>
自定義 Session 儲存處理器
資料庫儲存 (PDO 範例)
<?php
class PdoSessionHandler implements SessionHandlerInterface {
private PDO $pdo;
public function __construct(PDO $pdo) {
$this->pdo = $pdo;
// 建立資料表
$this->pdo->exec("CREATE TABLE IF NOT EXISTS sessions (
id VARCHAR(128) PRIMARY KEY,
data TEXT NOT NULL,
expiry INT UNSIGNED NOT NULL
)");
}
public function open($path, $name): 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() + 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();
}
}
// 註冊
$handler = new PdoSessionHandler($pdo);
session_set_save_handler($handler, true);
session_start();
?>
Redis 儲存 (高效能、分散式)
<?php
// php.ini 或 ini_set
ini_set('session.save_handler', 'redis');
ini_set('session.save_path', 'tcp://127.0.0.1:6379?auth=password&database=0&prefix=session:');
// 或程式碼註冊
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$handler = new RedisSessionHandler($redis);
session_set_save_handler($handler, true);
session_start();
?>
閃存訊息模式
<?php
// 設定閃存 (僅下一次請求可見)
function flash(string $key, string $message): void {
$_SESSION['_flash'][$key] = $message;
}
// 取得並清除閃存
function getFlash(string $key): ?string {
$msg = $_SESSION['_flash'][$key] ?? null;
unset($_SESSION['_flash'][$key]);
return $msg;
}
// 使用範例
// process.php
flash('success', '資料已儲存');
header('Location: list.php');
// list.php
if ($msg = getFlash('success')) {
echo '<div class="alert-success">' . h($msg) . '</div>';
}
?>
分散式系統 Session 共享策略
| 策略 | 原理 | 優點 | 缺點 |
| Sticky Session | 負載均衡器綁定 Session 到特定後端 | 簡單、無程式碼變更 | 單點故障、擴展受限 |
| 共享儲存 (Redis/DB) | 所有節點讀寫同一儲存 | 高可用、水平擴展 | 網路延遲、單點儲存風險 |
| JWT Stateless | 狀態編碼在 Token,無伺服器儲存 | 完全無狀態、極易擴展 | Token 體積大、撤銷困難、無法存大量資料 |
| Session 複寫 | 節點間同步 Session 資料 | 本地讀取快 | 複雜、一致性難保證 |
✅ 生產環境清單:
- ✅ HTTPS + Secure + HttpOnly + SameSite=Lax
- ✅ use_strict_mode=1 防 Session Fixation
- ✅ 定期 session_regenerate_id(true)
- ✅ 共享儲存 (Redis Cluster) 支援水平擴展
- ✅ 監控 Session 數量、GC 效能
- ✅ 敏感操作重新驗證 (Re-authentication)