核心函數速查
| 函數 | 用途 | 範例 | 備註 |
| session_start() | 啟動/恢復會話 | session_start(); | 必須在輸出前呼叫 |
| session_destroy() | 銷毀伺服器端會話資料 | session_destroy(); | 不刪除 $_SESSION 變數、不刪除 Cookie |
| session_unset() | 釋放所有 $_SESSION 變數 | session_unset(); | $_SESSION = [] 同效 |
| session_regenerate_id() | 生成新 Session ID | session_regenerate_id(true); | true=刪除舊檔案,登入後必呼叫 |
| session_id() | 取得/設定當前 ID | $id = session_id(); | 啟動前呼叫可指定 ID |
| session_name() | 取得/設定 Cookie 名稱 | session_name('MYAPP'); | 啟動前呼叫,預設 PHPSESSID |
| session_get_cookie_params() | 取得 Cookie 參數 | $p = session_get_cookie_params(); | 陣列: lifetime, path, domain, secure, httponly, samesite |
| session_set_cookie_params() | 設定 Cookie 參數 | session_set_cookie_params(3600, '/', '.example.com', true, true); | 啟動前呼叫 |
| session_save_path() | 取得/設定儲存路徑 | session_save_path('/var/lib/php/sessions'); | 需目錄可寫、權限 1733 |
| session_status() | 取得會話狀態 | session_status() === PHP_SESSION_ACTIVE | PHP_SESSION_DISABLED/NONE/ACTIVE |
| session_write_close() | 寫入並關閉會話鎖 | session_write_close(); | 長時間請求釋放鎖,允許並發 |
| session_reset() | 重新載入會話資料 (捨棄未存變更) | session_reset(); | PHP 5.6+ |
| session_encode() | 序列化會話資料 | $data = session_encode(); | 內部格式,非標準 serialize |
| session_decode() | 反序列化會話資料 | session_decode($data); | 填入 $_SESSION |
php.ini 關鍵配置 (生產環境建議值)
; === 基礎 ===
session.save_handler = redis ; 檔案改用 Redis (生產必備)
session.save_path = "tcp://redis:6379?prefix=sess:"
session.name = MYAPPSESSID ; 自訂 Cookie 名稱,隱藏 PHP 特徵
; === 安全 (最高優先級) ===
session.cookie_httponly = 1 ; 防 XSS 竊取 (JS 不可讀)
session.cookie_secure = 1 ; 僅 HTTPS 傳輸 (需全站 HTTPS)
session.cookie_samesite = "Lax" ; 防 CSRF (Strict 可能影響外部連結登入)
session.use_strict_mode = 1 ; 拒絕未初始化 ID,防固定攻擊
session.sid_length = 48 ; ID 長度 48 字元 (更難暴力)
session.sid_bits_per_character = 5 ; 每字元 5 bits,更緊湊
; === 生命週期 ===
session.gc_maxlifetime = 7200 ; 2 小時 (視業務調整)
session.gc_probability = 1
session.gc_divisor = 1000 ; 0.1% 機率觸發 GC
session.cookie_lifetime = 0 ; 0 = 瀏覽器關閉失效,或設定秒數
; === 進階 ===
session.serialize_handler = igbinary ; 需安裝 igbinary,序列化更快更小
session.cache_limiter = nocache ; 防止頁面被快取
session.use_cookies = 1
session.use_only_cookies = 1 ; 僅用 Cookie 傳遞 ID,禁用 URL 傳遞 (防注入)
session.referer_check = "" ; 可限制來源域名 (嚴格場景)
安全最佳實踐清單
1. 防 Session Fixation (會話固定)
<?php
// 登入驗證成功後
if ($user = authenticate($username, $password)) {
// 1. 重新生成 ID (刪除舊資料)
session_regenerate_id(true);
// 2. 寫入新會話資料
$_SESSION['user_id'] = $user->id;
$_SESSION['role'] = $user->role;
$_SESSION['last_activity'] = time();
// 3. (可選) 綁定用戶代理指紋
$_SESSION['ua_hash'] = hash('sha256', $_SERVER['HTTP_USER_AGENT'] ?? '');
// 4. 導向安全區域
header('Location: /dashboard');
exit;
}
2. 防 Session Hijacking (會話劫持)
<?php
// 每請求驗證 (中介軟體/基礎控制器)
function validateSession() {
if (session_status() !== PHP_SESSION_ACTIVE) session_start();
// 檢查 User-Agent 一致性 (可選,行動裝置可能變動)
if (isset($_SESSION['ua_hash'])) {
$current = hash('sha256', $_SERVER['HTTP_USER_AGENT'] ?? '');
if (!hash_equals($_SESSION['ua_hash'], $current)) {
destroySession();
throw new SecurityException('Session UA mismatch');
}
}
// 檢查 IP 前綱一致性 (可選,/24 網段)
if (isset($_SESSION['ip_prefix'])) {
$current = implode('.', array_slice(explode('.', $_SERVER['REMOTE_ADDR']), 0, 3));
if ($_SESSION['ip_prefix'] !== $current) {
// 僅記錄告警,不強制登出 (行動網路常換 IP)
error_log("Session IP change: {$_SESSION['ip_prefix']} -> $current");
}
}
// 更新最後活動時間
$_SESSION['last_activity'] = time();
}
function destroySession() {
$_SESSION = [];
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();
}
3. 閒置超時自動登出
<?php
// 配合 gc_maxlifetime,但伺服器 GC 不精確,需應用層控制
$idle_timeout = 1800; // 30 分鐘無操作登出
if (isset($_SESSION['last_activity'])) {
$idle = time() - $_SESSION['last_activity'];
if ($idle > $idle_timeout) {
destroySession();
header('Location: /login?timeout=1');
exit;
}
}
$_SESSION['last_activity'] = time();
4. 並發請求阻塞問題 (Session Lock)
<?php
// 問題:同一 Session 並發請求會串列執行 (檔案鎖/Redis 鎖)
// 解決:提前釋放鎖
session_start();
// 讀取必要資料
$userId = $_SESSION['user_id'];
$perms = $_SESSION['permissions'];
// 釋放鎖,允許其他請求並行
session_write_close();
// 耗時操作:API 呼叫、大量查詢、檔案處理...
$report = generateHeavyReport($userId);
// 如需再寫入 Session,需重新啟動
session_start();
$_SESSION['last_report'] = $report['id'];
// 請求結束自動寫入
儲存驅動選擇指南
| 驅動 | 適用場景 | 優點 | 缺點 | 配置複雜度 |
| files (預設) | 單機、低流量、開發環境 | 零配置 | 多機不共享、鎖爭用、inode 耗盡 | 低 |
| redis | 生產環境、叢集、高併發 | 高效能、共享、支援 TTL 原生過期、無鎖/樂觀鎖 | 需 Redis 服務、網路延遲 | 中 |
| memcached | 簡單快取、不需持久化 | 極快、簡單 | 資料可能被驅逐、無備份、無原生掃描 | 中 |
| database (PDO) | 需持久化、審計、無 Redis | ACID、可查詢、備份容易 | 較慢、需手動 GC、連線池壓力 | 高 |
| custom (Swoole/Table) | Swoole 協程環境 | 記憶體級速度、無鎖 | 進程重啟丟失、需持久化備份 | 高 |
常見問題快速排查
- session_start() 警告 "headers already sent"
- 檢查:1) 檔案開頭無 BOM 2) 無 `echo`/`print`/HTML/空白在 `session_start()` 前 3) `ob_start()` 開啟輸出緩衝
- Session 變數跨頁面消失
- 1) 確認每頁都 `session_start()` 2) `session.cookie_domain` 設定正確 (跨子域) 3) `session.save_path` 目錄權限 4) GC 過於激進 5) 多伺服器未共享儲存
- 無法登入 / 登入後立即登出
- 1) Cookie 被瀏覽器封鎖 (第三方 Cookie、Secure/Httponly 設定錯誤) 2) 時區差異導致過期判斷錯誤 3) `session_regenerate_id` 未傳 `true` 導致舊檔案殘留
- 雙系統整合共享 Session
- 同一儲存後端 (Redis) + 相同 `session.name` + 相同 `session.save_path` prefix + 同步 `session.serialize_handler`
現代框架封裝參考 (Laravel / Symfony / Yii)
<?php
// Laravel: config/session.php 驅動設定,自動處理加密、閃存、CSRF
// 使用:session('key'), session(['key' => 'val']), $request->session()->put()
// 閃存:session()->flash('status', '已儲存!')
// Symfony: session service, framework.yaml 設定 handler
// 使用:$request->getSession()->set('key', 'val')
// 原生 PHP 簡易封裝類
class Session {
public static function start(array $options = []) {
foreach ($options as $k => $v) ini_set("session.$k", $v);
if (session_status() === PHP_SESSION_NONE) session_start();
}
public static function get($key, $default = null) { return $_SESSION[$key] ?? $default; }
public static function put($key, $value) { $_SESSION[$key] = $value; }
public static function forget($key) { unset($_SESSION[$key]); }
public static function flush() { $_SESSION = []; }
public static function regenerate($deleteOld = true) { session_regenerate_id($deleteOld); }
public static function destroy() { self::flush(); session_destroy(); }
}
總結
Session 是 PHP 有狀態應用的基石。關鍵原則:
- 安全第一:HTTPS + HttpOnly + SameSite + Strict Mode + 登入後 Regenerate ID
- 生產上 Redis:解決共享、鎖、效能、GC 三大痛點
- 資料極小化:只存身分證明,業務資料走快取/資料庫
- 應用層控制閒置:不依賴不可預測的 GC
- 並發釋放鎖:長請求 `session_write_close()`