萬盛學電腦網

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

PHP 自定義 Session 處理器:基於 MySQL 存儲實現 session_set_save_handler

為什麼自定義 Session 存儲?

  • **多服務器負載均衡**:文件存儲無法共享,需中心化存儲(MySQL/Redis/Memcached)。
  • **在線用戶統計**:直接查詢 Session 表獲取活躍用戶。
  • **精確控制過期清理**:DB 層面定時任務清理,避免文件 GC 隨機性。
  • **安全審計**:記錄登錄 IP、User-Agent、最後活動時間。

數據表結構

CREATE TABLE `sessions` (
    `session_id` CHAR(32) NOT NULL PRIMARY KEY,
    `user_id`    INT UNSIGNED NOT NULL DEFAULT 0,
    `data`       TEXT NOT NULL,
    `last_activity` INT UNSIGNED NOT NULL DEFAULT 0,
    `ip_address` VARCHAR(45) DEFAULT '',
    `user_agent` TEXT DEFAULT '',
    INDEX `idx_last_activity` (`last_activity`),
    INDEX `idx_user_id` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

完整處理器類實現

<?php
class MySQLSessionHandler implements SessionHandlerInterface {
    private PDO $pdo;
    private int $lifetime;

    public function __construct(PDO $pdo, int $lifetime = 3600) {
        $this->pdo = $pdo;
        $this->lifetime = $lifetime;
    }

    // 打開會話(返回 true 表示成功)
    public function open(string $savePath, string $sessionName): bool {
        return true; // PDO 連接已在構造函數建立
    }

    // 關閉會話
    public function close(): bool {
        return true;
    }

    // 讀取會話數據
    public function read(string $sessionId): string|false {
        $stmt = $this->pdo->prepare('SELECT `data` FROM `sessions` WHERE `session_id` = ? AND `last_activity` > ? LIMIT 1');
        $stmt->execute([$sessionId, time() - $this->lifetime]);
        $row = $stmt->fetch(PDO::FETCH_COLUMN);
        return $row !== false ? $row : '';
    }

    // 寫入會話數據
    public function write(string $sessionId, string $data): bool {
        $userId = 0;
        // 嘗試從序列化數據中提取 user_id(可選)
        if (preg_match('/user_id\|i:(\d+);/', $data, $m)) {
            $userId = (int)$m[1];
        }
        $stmt = $this->pdo->prepare(
            'INSERT INTO `sessions` (`session_id`, `user_id`, `data`, `last_activity`) VALUES (?, ?, ?, ?)
             ON DUPLICATE KEY UPDATE `user_id` = VALUES(`user_id`), `data` = VALUES(`data`), `last_activity` = VALUES(`last_activity`)'
        );
        return $stmt->execute([$sessionId, $userId, $data, time()]);
    }

    // 銷毀會話
    public function destroy(string $sessionId): bool {
        $stmt = $this->pdo->prepare('DELETE FROM `sessions` WHERE `session_id` = ?');
        return $stmt->execute([$sessionId]);
    }

    // 垃圾回收(刪除過期)
    public function gc(int $maxLifetime): int|false {
        $stmt = $this->pdo->prepare('DELETE FROM `sessions` WHERE `last_activity` < ?');
        $stmt->execute([time() - $maxLifetime]);
        return $stmt->rowCount();
    }
}

註冊並啟動

<?php
require 'db.php'; // 返回 $pdo 實例

$handler = new MySQLSessionHandler($pdo, 3600); // 1 小時過期
session_set_save_handler($handler, true); // true = 註冊關閉函數
session_start();

// 現在 $_SESSION 讀寫自動走 MySQL
$_SESSION['user_id'] = 123;
$_SESSION['name'] = 'Alice';

關鍵 php.ini Session 配置解讀

指令推薦值說明
session.save_handleruser使用用戶自定義處理器
session.save_path/tmp (無效,由處理器決定)文件存儲時的路徑;自定義處理器忽略
session.namePHPSESSIDCookie 名稱
session.auto_start0禁止自動啟動(類定義需先載入)
session.gc_probability1GC 概率分子
session.gc_divisor1000GC 概率分母(1/1000 請求觸發)
session.gc_maxlifetime1440最大生存秒數(GC 判斷標準)
session.use_cookies1使用 Cookie 傳遞 ID
session.use_only_cookies1禁止 URL 傳 ID(防會話固定)
session.cookie_httponly1JS 不可讀
session.cookie_secure1僅 HTTPS(生產必開)
session.cookie_samesiteLaxCSRF 防護

生產環境建議:改用 Redis

MySQL 寫入有鎖開銷,高併發下建議使用 **Redis**(原子操作、亞毫秒延遲、內建 TTL 自動過期):

class RedisSessionHandler implements SessionHandlerInterface {
    private Redis $redis;
    private string $prefix = 'sess:';
    public function __construct(Redis $redis) { $this->redis = $redis; }
    public function read($id) { return $this->redis->get($this->prefix . $id) ?: ''; }
    public function write($id, $data) { return $this->redis->setex($this->prefix . $id, 3600, $data); }
    public function destroy($id) { return $this->redis->del($this->prefix . $id); }
    public function gc($maxLifetime) { return 0; } // Redis 自動過期,無需 GC
    public function open($p, $n) { return true; }
    public function close() { return true; }
}
copyright © 萬盛學電腦網 all rights reserved