PHP 4 引入 Session 處理器介面,允許開發者以 6 個回呼函式(open/close/read/write/destroy/gc)替換預設檔案儲存。本文完整實作兩款驅動:DBM 鍵值檔案(適合單機共享主機)與 MySQL 資料庫(適合多機負載均衡共享 Session),並解析序列化、過期掃描、併發鎖等關鍵細節。
function sess_open(string $savePath, string $sessionName): bool
function sess_close(): bool
function sess_read(string $id): string|false
function sess_write(string $id, string $data): bool
function sess_destroy(string $id): bool
function sess_gc(int $maxLifetime): int|false
註冊方式:session_set_save_handler('sess_open', 'sess_close', 'sess_read', 'sess_write', 'sess_destroy', 'sess_gc');
重要:註冊必須在 session_start() **之前**呼叫。
<?php
// session_dbm.php
$dbmPath = '/tmp/PHPSESSID.dbm'; // 需寫入權限
function sess_open($savePath, $sessionName) {
global $dbmPath, $dbmHandle;
$dbmHandle = dba_open($dbmPath, 'c', 'db4'); // 或 gdbm, ndbm
return $dbmHandle !== false;
}
function sess_close() {
global $dbmHandle;
return dba_close($dbmHandle);
}
function sess_read($id) {
global $dbmHandle;
$data = dba_fetch($id, $dbmHandle);
if ($data === false) return '';
// 格式:expiry|serialized_data
[$expiry, $payload] = explode('|', $data, 2);
if (time() > (int)$expiry) {
dba_delete($id, $dbmHandle);
return '';
}
return $payload;
}
function sess_write($id, $data) {
global $dbmHandle;
$expiry = time() + ini_get('session.gc_maxlifetime');
return dba_replace($id, $expiry . '|' . $data, $dbmHandle);
}
function sess_destroy($id) {
global $dbmHandle;
return dba_delete($id, $dbmHandle);
}
function sess_gc($maxLifetime) {
global $dbmHandle;
$deleted = 0;
$now = time();
// DBM 無游標遍歷效能極差,僅示意
// 實務建議改用 MySQL/Redis 驅動
return $deleted;
}
// 註冊
session_set_save_handler('sess_open','sess_close','sess_read','sess_write','sess_destroy','sess_gc');
session_start();
缺點:dba_* 無高效掃描介面,sess_gc 需全表掃描極慢;DBM 並發寫入易損壞,**不建議高併發生產使用**。
CREATE DATABASE sessions CHARSET utf8mb4;
CREATE USER 'phpsess'@'%' IDENTIFIED BY 'strong_password';
GRANT SELECT,INSERT,UPDATE,DELETE ON sessions.* TO 'phpsess'@'%';
CREATE TABLE sessions (
sesskey CHAR(32) NOT NULL PRIMARY KEY,
expiry INT UNSIGNED NOT NULL,
value MEDIUMBLOB NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
<?php
// session_mysql.php
$dsn = 'mysql:host=127.0.0.1;dbname=sessions;charset=utf8mb4';
$user = 'phpsess'; $pass = 'strong_password';
$pdo = null;
function sess_open($savePath, $sessionName) {
global $pdo, $dsn, $user, $pass;
try {
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES => false,
PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4",
]);
return true;
} catch (PDOException $e) {
error_log('Session DB connect failed: ' . $e->getMessage());
return false;
}
}
function sess_close() {
global $pdo;
$pdo = null; // 依賴 PHP 關閉持久連線
return true;
}
function sess_read($id) {
global $pdo;
$stmt = $pdo->prepare('SELECT value FROM sessions WHERE sesskey = ? AND expiry > ?');
$stmt->execute([$id, time()]);
$row = $stmt->fetch(PDO::FETCH_COLUMN);
return $row ?: '';
}
function sess_write($id, $data) {
global $pdo;
$expiry = time() + (int)ini_get('session.gc_maxlifetime');
// INSERT ... ON DUPLICATE KEY UPDATE
$stmt = $pdo->prepare('INSERT INTO sessions (sesskey, expiry, value) VALUES (?, ?, ?)
ON DUPLICATE KEY UPDATE expiry = VALUES(expiry), value = VALUES(value)');
return $stmt->execute([$id, $expiry, $data]);
}
function sess_destroy($id) {
global $pdo;
$stmt = $pdo->prepare('DELETE FROM sessions WHERE sesskey = ?');
return $stmt->execute([$id]);
}
function sess_gc($maxLifetime) {
global $pdo;
$stmt = $pdo->prepare('DELETE FROM sessions WHERE expiry < ?');
$stmt->execute([time()]);
return $stmt->rowCount();
}
// 註冊
session_set_save_handler('sess_open','sess_close','sess_read','sess_write','sess_destroy','sess_gc');
session_start();
| 議題 | 解決方案 |
|---|---|
| 併發寫入衝突 | MySQL 行鎖 + ON DUPLICATE KEY UPDATE 原子化 |
| Session 鎖阻塞 | PHP 7+ session_write_close() 盡早釋放鎖;長任務改用 Queue |
| GC 效能 | 定時任務 DELETE WHERE expiry < NOW() 替代 sess_gc 機率觸發 |
| 多資料中心 | 改用 Redis Cluster / Memcached,單機 MySQL 成瓶頸 |
| 序列化格式 | 預設 php_serialize(PHP 5.5.4+),避免 php 舊格式相容問題 |
; php.ini
session.save_handler = redis
session.save_path = "tcp://127.0.0.1:6379?auth=password&database=0&prefix=PHPSESSID:"
# 或多節點
# session.save_path = "tcp://host1:6379,tcp://host2:6379?weight=1,2"
無需寫任何代碼,原生支援鎖、集群、TTL 自動過期,效能遠超 MySQL/DBM。