| 參數 | 預設值 | 建議值 | 說明 |
| session.save_handler | files | files / redis / memcached | 儲存引擎 |
| session.save_path | /tmp | /var/lib/php/sessions (權限 1733) | 檔案儲存路徑 |
| session.gc_maxlifetime | 1440 (24分) | 7200 (2小時) 或更長 | 資料最大存活秒數 |
| session.gc_probability | 1 | 1 | GC 機率分子 |
| session.gc_divisor | 1000 | 1000 | GC 機率分母 (1/1000 請求觸發) |
| session.cookie_lifetime | 0 (瀏覽器關閉失效) | 0 或具體秒數 | Cookie 存活時間 |
| session.cookie_httponly | Off | On | 防 XSS 竊取 Cookie (JS 無法讀取) |
| session.cookie_secure | Off | On (HTTPS 環境) | 僅 HTTPS 傳輸 Cookie |
| session.cookie_samesite | '' (PHP 7.3-) | Lax 或 Strict | 防 CSRF (PHP 7.3+) |
| session.use_strict_mode | Off | On | 拒絕未初始化的 Session ID |
| session.sid_length | 32 | 48 或 64 | Session ID 長度 (PHP 7.1+) |
| session.sid_bits_per_character | 4 | 5 或 6 | 字元編碼位數,值越大 ID 越短 |
基本操作 API
<?php
// 1. 啟動 Session (必須在輸出前)
session_start();
// 或自動啟動 (不推薦,無法存物件)
// ini_set('session.auto_start', 1);
// 2. 讀寫資料 (超全域陣列 $_SESSION)
$_SESSION['user_id'] = 12345;
$_SESSION['username'] = 'john_doe';
$_SESSION['permissions'] = ['read', 'write', 'admin'];
$_SESSION['cart'] = [
['product_id' => 1, 'qty' => 2],
['product_id' => 5, 'qty' => 1],
];
// 讀取
$userId = $_SESSION['user_id'] ?? null;
$cartCount = count($_SESSION['cart'] ?? []);
// 3. 檢查變數是否存在
isset($_SESSION['key']);
empty($_SESSION['key']);
// 4. 刪除單一變數
unset($_SESSION['temp_data']);
// 5. 刪除所有 Session 資料 (保留 Session ID)
$_SESSION = [];
// 6. 徹底銷毀 Session (登出)
session_unset(); // 清空 $_SESSION
session_destroy(); // 刪除伺服器端儲存檔案
// 同時刪除客戶端 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']
);
}
// 7. 重新生成 Session ID (防 Session Fixation 攻擊)
// 登入成功後、權限變更後必須呼叫
session_regenerate_id(true); // true = 刪除舊儲存檔案
Session 儲存驅動擴充
預設:檔案系統 (files)
優點:零配置、無依賴
缺點:多伺服器不共享、大量檔案 inode 耗盡、IO 瓶頸
Redis (推薦生產環境)
; php.ini 或執行時設定
session.save_handler = redis
session.save_path = "tcp://127.0.0.1:6379?auth=password&database=0&prefix=session:"
; 選項:weight=1, timeout=2.5, read_timeout=2.0, retry_interval=10
<?php
// 程式碼設定 (優先級較高)
ini_set('session.save_handler', 'redis');
ini_set('session.save_path', 'tcp://redis:6379?prefix=sess:');
session_start();
資料庫 (MySQL/PostgreSQL)
<?php
class PdoSessionHandler implements SessionHandlerInterface {
private $pdo;
public function __construct(PDO $pdo) { $this->pdo = $pdo; }
public function open($path, $name) { return true; }
public function close() { return true; }
public function read($id) {
$stmt = $this->pdo->prepare("SELECT data FROM sessions WHERE id = ? AND expiry > ?");
$stmt->execute([$id, time()]);
return $stmt->fetchColumn() ?: '';
}
public function write($id, $data) {
$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) {
return $this->pdo->prepare("DELETE FROM sessions WHERE id = ?")->execute([$id]);
}
public function gc($maxlifetime) {
return $this->pdo->prepare("DELETE FROM sessions WHERE expiry < ?")->execute([time()]);
}
}
// 註冊
$handler = new PdoSessionHandler($pdo);
session_set_save_handler($handler, true);
session_start();
安全防護完整指南
1. Session Fixation (會話固定攻擊)
// 攻擊者誘導受害者使用已知 Session ID
// 防禦:登入/權限提升後強制重新生成 ID
session_regenerate_id(true);
2. Session Hijacking (會話劫持)
- HTTPS 全站強制:防止網路嗅探竊取 Session ID
session.cookie_secure = On + session.cookie_httponly = On
session.cookie_samesite = 'Lax' (或 Strict) 防 CSRF
- 綁定 User-Agent / IP 片段驗證 (需權衡行動裝置 IP 變動)
3. Session Injection (會話注入)
- 不要信任 `$_SESSION` 來源不明的資料
- 關鍵權限資料 (user_id, role) 僅在伺服器端驗證後寫入
常見問題與解決方案
- 「Headers already sent」無法啟動 Session
- 確保
session_start() 在任何輸出前 (包括空白行、BOM、HTML)。使用輸出緩衝 `ob_start()` 或調整程式碼順序。
- Session 資料丟失 / 變數不見
- 檢查:1) `session_start()` 是否每請求都呼叫 2) `session.save_path` 目錄可寫 3) 磁碟空間/Inode 充足 4) GC 過度清理 (調大 `gc_maxlifetime`) 5) 多伺服器未共享儲存 (改用 Redis)
- 跨子域名共享 Session
session_set_cookie_params(0, '/', '.example.com') + 同一儲存後端 (Redis/DB)
- AJAX 請求 Session 失效
- 確認 AJAX 請求攜帶 Cookie (`credentials: 'include'` / `withCredentials: true`),檢查 SameSite 設定
- 並發請求阻塞 (Session 鎖)
- PHP 預設鎖定 Session 檔案。長時間請求可
session_write_close() 釋放鎖,或改用 Redis (無鎖/樂觀鎖)
效能優化建議
- 儲存介質:高併發必上 Redis (或資料庫),避免檔案鎖爭用
- 資料精簡:Session 只存必要識別資訊 (user_id, permissions),大量資料用快取/資料庫
- 序列化優化:`session.serialize_handler = igbinary` (需擴充套件,體積更小、速度更快)
- 讀寫分離:Redis Cluster / Sentinel 高可用
- 非同步寫入:Swoole 環境下可異步持久化
現代框架整合範例 (Laravel)
<?php
// config/session.php
'driver' => env('SESSION_DRIVER', 'redis'),
'lifetime' => env('SESSION_LIFETIME', 120),
'expire_on_close' => false,
'encrypt' => true, // 加密 Session 資料
'files' => storage_path('framework/sessions'),
'connection' => 'session', // Redis 連線名稱
'table' => 'sessions', // 資料庫模式表名
'store' => null,
'lottery' => [2, 100], // GC 機率
'cookie' => 'laravel_session',
'path' => '/',
'domain' => env('SESSION_DOMAIN', null),
'secure' => env('SESSION_SECURE_COOKIE', true),
'http_only' => true,
'same_site' => 'lax',
'partitioned' => false,
總結
Session 是 PHP 狀態管理的基石。關鍵要點:
- 早啟動、早輸出:`session_start()` 放在腳本最頂端
- 安全三件套:HTTPS + `httponly` + `samesite`
- 防固定攻擊:關鍵操作後 `session_regenerate_id(true)`
- 分散式儲存:生產環境務必使用 Redis/資料庫替代檔案
- 資料極小化:Session 只存身分證明,業務資料另存
copyright ©
萬盛學電腦網 all rights reserved