PHP Session 過期 不是 靠定時器主動清理,而是 概率觸發的被動 GC:每次請求有 gc_probability / gc_divisor 的機率啟動掃描,刪除「最後修改時間超過 gc_maxlifetime 秒」的 Session 文件。
| 參數 | 預設值 | 含義 | 建議生產值 |
|---|---|---|---|
session.gc_probability | 1 | GC 觸發分子 | 1 |
session.gc_divisor | 1000 | GC 觸發分母(概率 = 1/1000) | 100(1% 概率,平衡性能與及時性) |
session.gc_maxlifetime | 1440 (24分) | Session 最大生存秒數 | 3600~86400 (1h~1天),視業務而定 |
session.cookie_lifetime | 0 | Cookie 存活秒數,0=瀏覽器關閉即失效 | 同 gc_maxlifetime 或 0 |
session.save_path | /tmp | Session 文件存儲路徑 | 專用目錄,權限 700,非公開目錄 |
低流量站點(如每天 100 請求),預期 10 天才觸發 1 次 GC。此期間過期文件堆積,佔用 inode、磁盤空間,甚至導致 open_basedir 掃描變慢。
; php.ini
session.gc_probability = 1
session.gc_divisor = 100 ; 1% 概率,約每 100 請求掃描一次
或運行時動態設置:
ini_set('session.gc_probability', 1);
ini_set('session.gc_divisor', 100);
禁用 PHP 內建 GC,改用系統 Cron 精確清理:
; php.ini
session.gc_probability = 0 ; 關閉內建 GC
# crontab -e 每小時執行
0 * * * * find /var/lib/php/sessions -type f -cmin +60 -delete
優勢:精確控制清理時間、不影響請求響應、可針對不同目錄設置不同策略。
完全繞過文件系統,利用 Redis TTL 自動過期:
<?php
class RedisSessionHandler implements SessionHandlerInterface {
private Redis $redis;
private int $ttl;
public function __construct(Redis $redis, int $ttl = 3600) {
$this->redis = $redis;
$this->ttl = $ttl;
}
public function open($path, $name): bool { return true; }
public function close(): bool { return true; }
public function read(string $id): string|false {
$data = $this->redis->get("sess:$id");
return $data !== false ? $data : '';
}
public function write(string $id, string $data): bool {
return $this->redis->setex("sess:$id", $this->ttl, $data);
}
public function destroy(string $id): bool {
return (bool)$this->redis->del("sess:$id");
}
public function gc(int $maxLifetime): int|false { return 0; } // Redis TTL 自動過期,無需 GC
}
// 註冊
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
ini_set('session.save_handler', 'user');
session_set_save_handler(new RedisSessionHandler($redis, 3600), true);
session_start();
問題:用戶持續操作但未修改 $_SESSION 內容(如純瀏覽),文件 mtime 不變,GC 會誤刪。
解決:定期更新一個時間戳字段:
<?php
if (!isset($_SESSION['_active']) || time() - $_SESSION['_active'] > 60) {
$_SESSION['_active'] = time(); // 每 60 秒觸發一次寫入,刷新 mtime
}
<?php
function start_session(int $expire = 3600): void {
// 1. 設置 GC 生命週期
ini_set('session.gc_maxlifetime', (string)$expire);
// 2. 設置 Cookie 生命週期(0=會話級,>0=持久化秒數)
$cookieParams = session_get_cookie_params();
session_set_cookie_params([
'lifetime' => $expire, // 與 GC 一致
'path' => $cookieParams['path'],
'domain' => $cookieParams['domain'],
'secure' => isset($_SERVER['HTTPS']), // 僅 HTTPS 傳輸
'httponly' => true, // 防 XSS
'samesite' => 'Lax', // CSRF 防護
]);
session_start();
// 3. 若已有 Session ID,手動刷新 Cookie 過期時間(應對 gc_maxlifetime < cookie_lifetime 邊界情況)
if (!empty($_COOKIE[session_name()])) {
setcookie(session_name(), session_id(), time() + $expire, ...$cookieParams);
}
}
session.gc_maxlifetime 但不調整 gc_divisor → 過期文件堆積。/tmp 存儲 Session → 競爭條件、GC 衝突。必須用共享存儲。session.cookie_lifetime=0 即安全 → 瀏覽器不關閉標籤頁 Cookie 不會過期,需配合服務端 GC。PHP Session 過期本質是 「文件 mtime + 概率 GC」 的組合。理解機制後,小流量調大 gc_divisor,中大流量上 Redis,定時任務兜底 是最穩妥的架構選擇。