Session 是 Web 應用維持狀態的核心機制,PHP 內建 $_SESSION 超全域陣列提供簡單易用的介面。本文涵蓋 Session 全生命週期操作、設定調優、安全防護與常見問題排查。
<?php
// 必須在任何輸出前呼叫
session_start();
// 可選:設定儲存路徑、名稱、過期時間
// session_save_path('/var/lib/php/sessions');
// session_name('MYAPP_SESS');
// ini_set('session.gc_maxlifetime', 3600); // 1 小時
?>
<?php
$_SESSION['user_id'] = 12345;
$_SESSION['username'] = 'admin';
$_SESSION['roles'] = ['admin', 'editor'];
$_SESSION['login_at'] = time();
$_SESSION['csrf_token'] = bin2hex(random_bytes(32)); // 防 CSRF
?>
支援型別:字串、整數、浮點、布林、陣列、物件 (需實作 Serializable 或 __sleep/__wakeup)。
<?php
session_start();
if (isset($_SESSION['user_id'])) {
$uid = $_SESSION['user_id'];
$name = $_SESSION['username'];
// 使用...
}
?>
unset($_SESSION['csrf_token']); // 僅移除單一鍵
<?php
session_start();
// 清空所有 session 變數
$_SESSION = array();
// 刪除客戶端 Cookie 中的 session ID
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();
header('Location: login.php');
exit;
?>
$sid = session_id(); // 當前 session ID
$sid = SID; // 常數形式 (PHP < 7.2 已棄用)
| 指令 | 建議值 | 說明 |
|---|---|---|
| session.save_handler | files / redis / memcached | 預設 files,叢集環境建議 Redis |
| session.save_path | /var/lib/php/sessions | 檔案儲存路徑,確保權限 700、擁有者正確 |
| session.gc_maxlifetime | 1440 (秒) | 垃圾回收最大壽命,依業務調整 |
| session.gc_probability | 1 | GC 機率分子 |
| session.gc_divisor | 1000 | GC 機率分母 (1/1000 請求觸發) |
| session.cookie_httponly | 1 | 防 XSS 竊取 Cookie |
| session.cookie_secure | 1 (HTTPS 環境) | 僅 HTTPS 傳輸 Cookie |
| session.use_strict_mode | 1 | 拒絕未初始化的 Session ID |
| session.sid_length | 32 | ID 長度,越長越安全 |
session_regenerate_id(true) 防止 Session Fixation$_SESSION['last_activity'] 檢查,超過閾值強制登出| 現象 | 原因 | 解決 |
|---|---|---|
| Session 變數丟失 | 未呼叫 session_start()、輸出前有空白字元 | 確保最頂端唯一啟動、檢查 BOM、關閉 output_buffering 測試 |
| 跨子域名共享失效 | Cookie domain 設定錯誤 | 設定 session.cookie_domain = '.example.com' |
| 並發請求阻塞 | 預設檔案鎖定機制 | 使用 session_write_close() 釋放鎖、或改用 Redis |
| 物件無法序列化 | 資源型別、Closure、未實作 Serializable | 僅存純資料陣列/DTO,或實作 __sleep/__wakeup |