萬盛學電腦網

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

PHP 自定義 Session 儲存處理器:資料庫儲存完整實現與陷阱避坑

為什麼需要自定義 Session 處理器?

預設 `files` 處理器在高併發、分散式部署下存在:磁碟 I/O 瓶頸、檔案鎖競爭、多伺服器無法共享 等問題。資料庫儲存提供:ACID 保證、集中管理、易於查詢分析、支援叢集。

資料庫表結構設計

CREATE TABLE `sessions` (
    `session_id` VARCHAR(128) NOT NULL PRIMARY KEY,
    `session_data` TEXT NOT NULL,
    `expire_time` INT(11) UNSIGNED NOT NULL,
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    INDEX `idx_expire` (`expire_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

關鍵點:

  • `session_id` 長度 128 相容 PHP 7.1+ `session.sid_length=256`
  • `expire_time` 儲存 Unix 時間戳,便於 GC 掃描
  • InnoDB 行級鎖支援高併發

完整 SessionHandler 實現(PDO 版,防注入)

<?php
class PdoSessionHandler implements SessionHandlerInterface {
    private PDO $pdo;
    private string $table;
    private int $lifetime;
    
    public function __construct(PDO $pdo, string $table = 'sessions', int $lifetime = 1440) {
        $this->pdo = $pdo;
        $this->table = $table;
        $this->lifetime = $lifetime;
        
        // 關鍵:關閉預設陣列模式,使用關聯陣列
        $this->pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
        $this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    }
    
    // 開啟 Session(建立資料庫連線)
    public function open(string $savePath, string $sessionName): bool {
        // PDO 在建構子已連線,這裡可做額外檢查
        return true;
    }
    
    // 關閉 Session
    public function close(): bool {
        return true; // PDO 連線由外部管理(單例/連線池)
    }
    
    // 讀取 Session 資料
    public function read(string $sessionId): string|false {
        $stmt = $this->pdo->prepare(
            "SELECT session_data FROM {$this->table} 
             WHERE session_id = :id AND expire_time > :now"
        );
        $stmt->execute([
            ':id' => $sessionId,
            ':now' => time()
        ]);
        
        $row = $stmt->fetch();
        return $row ? $row['session_data'] : '';
    }
    
    // 寫入/更新 Session 資料
    public function write(string $sessionId, string $data): bool {
        $expire = time() + $this->lifetime;
        
        // 使用 INSERT ... ON DUPLICATE KEY UPDATE (MySQL)
        // 或 PostgreSQL: INSERT ... ON CONFLICT (session_id) DO UPDATE
        $sql = "INSERT INTO {$this->table} (session_id, session_data, expire_time) 
                VALUES (:id, :data, :expire)
                ON DUPLICATE KEY UPDATE 
                    session_data = :data, 
                    expire_time = :expire,
                    updated_at = CURRENT_TIMESTAMP";
        
        $stmt = $this->pdo->prepare($sql);
        return $stmt->execute([
            ':id' => $sessionId,
            ':data' => $data,
            ':expire' => $expire
        ]);
    }
    
    // 銷毀 Session
    public function destroy(string $sessionId): bool {
        $stmt = $this->pdo->prepare("DELETE FROM {$this->table} WHERE session_id = :id");
        return $stmt->execute([':id' => $sessionId]);
    }
    
    // 垃圾回收:清理過期 Session
    public function gc(int $maxLifetime): int|false {
        $stmt = $this->pdo->prepare(
            "DELETE FROM {$this->table} WHERE expire_time < :now"
        );
        $stmt->execute([':now' => time()]);
        return $stmt->rowCount();
    }
    
    // PHP 7.0+ 可選:建立新 Session ID
    public function create_sid(): string {
        return bin2hex(random_bytes(32)); // 256 bits 安全隨機 ID
    }
    
    // PHP 7.0+ 可選:驗證 Session ID 格式
    public function validate_sid(string $sessionId): bool {
        return (bool)preg_match('/^[a-zA-Z0-9,\-]{22,256}$/', $sessionId);
    }
}

// 註冊處理器(必須在 session_start() 之前)
$pdo = new PDO('mysql:host=127.0.0.1;dbname=myapp;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_PERSISTENT => true, // 生產環境建議啟用持久連線
    PDO::ATTR_EMULATE_PREPARES => false,
]);

$handler = new PdoSessionHandler($pdo, 'sessions', 1800); // 30 分鐘過期
session_set_save_handler($handler, true); // true = 使用 OOP 介面
session_start();
?>

關鍵陷阱與解決方案

陷阱 1:Session 尚未啟動就嘗試操作資料庫

<?php
// 錯誤:在 session_set_save_handler 之前就用到 $_SESSION
session_set_save_handler($handler, true);
$_SESSION['test'] = 'value'; // Fatal error: Session not active
session_start(); // 太晚了!

// 正確順序
session_set_save_handler($handler, true);
session_start(); // 先啟動
$_SESSION['test'] = 'value'; // 現在可以用了
?>

陷阱 2:GC 執行頻率與效能平衡

<?php
// php.ini 關鍵設定
session.gc_probability = 1
session.gc_divisor = 1000      // 0.1% 機率觸發 GC(高流量站點建議 1000)
session.gc_maxlifetime = 1440  // 必須 >= 程式碼中設定的 lifetime

// 或程式控制(關閉 PHP 內建 GC,由排程任務處理)
ini_set('session.gc_probability', 0);
// 每日 03:00 執行 cron: php artisan session:gc
?>

陷阱 3:並發寫入導致資料遺失

PHP Session 預設鎖機制(`session_start()` 阻塞直到鎖釋放)在資料庫層面**不自動生效**。

<?php
// 解決方案:使用 SELECT ... FOR UPDATE 行鎖
public function read(string $sessionId): string|false {
    $stmt = $this->pdo->prepare(
        "SELECT session_data FROM {$this->table} 
         WHERE session_id = :id AND expire_time > :now
         FOR UPDATE" // 關鍵:獲取排他鎖
    );
    $stmt->execute([':id' => $sessionId, ':now' => time()]);
    return $stmt->fetchColumn() ?: '';
}

// 注意:需配合交易確保一致性
public function write(string $sessionId, string $data): bool {
    $this->pdo->beginTransaction();
    try {
        // ... write logic ...
        $this->pdo->commit();
        return true;
    } catch (Exception $e) {
        $this->pdo->rollBack();
        return false;
    }
}
?>

陷阱 4:AJAX 並發請求阻塞

同一 Session 的多個 AJAX 請求會**串列執行**(等待鎖釋放)。

<?php
// 讀取唯一操作:提前釋放鎖
session_start();
// 讀取完成後立即釋放鎖,允許其他請求並發
session_write_close(); 

// 後續耗時操作(查詢 API、發送郵件等)
$heavyResult = doHeavyTask();

// 需要寫入時重新啟動
session_start();
$_SESSION['result'] = $heavyResult;
// 請求結束自動寫入並釋放鎖
?>

效能優化建議

優化點建議
連線管理使用 PDO 持久連線 (`ATTR_PERSISTENT=true`) 或連線池 (PgBouncer, ProxySQL)
索引優化`expire_time` 建立索引加速 GC;高頻查詢考慮覆蓋索引
資料壓縮大 Session 資料用 `gzcompress()` 寫入,`gzuncompress()` 讀取
分表策略超過千萬筆按 `session_id` 哈希分 16/64 表
快取層熱門 Session 同步寫入 Redis (L2 Cache),讀取優先走 Redis

現代替代方案

  • Redis Session Handler:`session.save_handler = redis`,效能更高、支援 Cluster、內建 Lua 腳本原子操作
  • JWT Stateless:完全移除 Server-side Session,Token 自攜聲明,適合微服務架構
  • 資料庫 + 快取雙寫:資料庫持久化 + Redis 熱點快取,兼顧可靠與效能

總結

自定義 Session 處理器雖然靈活,但**正確處理並發鎖、GC 效能、連線管理**極具挑戰。生產環境強烈建議:

  1. 優先使用成熟庫(`symfony/http-foundation` NativeSessionStorage、Laravel Session、Redis Session Handler)
  2. 若必須自研,嚴格遵循 `SessionHandlerInterface`,並針對上述四大陷阱編寫整合測試
  3. 考慮無狀態架構(JWT/OAuth2)從根本消除 Session 共享難題
copyright © 萬盛學電腦網 all rights reserved