萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP Session 過期機制深度解析:原理、配置優化與最佳實踐

核心機制:垃圾回收 (GC) 是關鍵

PHP Session 過期 不是 靠定時器主動清理,而是 概率觸發的被動 GC:每次請求有 gc_probability / gc_divisor 的機率啟動掃描,刪除「最後修改時間超過 gc_maxlifetime 秒」的 Session 文件。

關鍵配置參數詳解

參數預設值含義建議生產值
session.gc_probability1GC 觸發分子1
session.gc_divisor1000GC 觸發分母(概率 = 1/1000)100(1% 概率,平衡性能與及時性)
session.gc_maxlifetime1440 (24分)Session 最大生存秒數3600~86400 (1h~1天),視業務而定
session.cookie_lifetime0Cookie 存活秒數,0=瀏覽器關閉即失效同 gc_maxlifetime 或 0
session.save_path/tmpSession 文件存儲路徑專用目錄,權限 700,非公開目錄

為什麼預設 1/1000 概率會導致「過期文件不刪除」?

低流量站點(如每天 100 請求),預期 10 天才觸發 1 次 GC。此期間過期文件堆積,佔用 inode、磁盤空間,甚至導致 open_basedir 掃描變慢。

三種解決方案(按推薦度排序)

方案一:調整 GC 概率(最簡單)

; 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

優勢:精確控制清理時間、不影響請求響應、可針對不同目錄設置不同策略。

方案三:自定義 SessionHandler 接入 Redis/DB(最現代)

完全繞過文件系統,利用 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 活躍保活技巧

問題:用戶持續操作但未修改 $_SESSION 內容(如純瀏覽),文件 mtime 不變,GC 會誤刪。

解決:定期更新一個時間戳字段:

<?php
if (!isset($_SESSION['_active']) || time() - $_SESSION['_active'] > 60) {
    $_SESSION['_active'] = time(); // 每 60 秒觸發一次寫入,刷新 mtime
}

Cookie 與 Session 協同配置

<?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。
  • ✅ 生產環境 強制使用 Redis/DB 存儲,徹底解決文件鎖、GC、分佈式一致性問題。

總結

PHP Session 過期本質是 「文件 mtime + 概率 GC」 的組合。理解機制後,小流量調大 gc_divisor,中大流量上 Redis,定時任務兜底 是最穩妥的架構選擇。

copyright © 萬盛學電腦網 all rights reserved