session_encode() 和 session_decode() 是 PHP 內置的 Session 數據序列化與反序列化函數,使用 PHP 專有格式(非標準 JSON/serialize)。本文深度解析其格式、用法、限制與替代方案。
<?php
session_start();
$_SESSION['user'] = ['id' => 1001, 'name' => '張三', 'roles' => ['admin', 'editor']];
$_SESSION['token'] = 'abc123';
$encoded = session_encode();
echo $encoded;
// 輸出類似:
// user|a:3:{i:0;s:4:"1001";s:4:"name";s:6:"張三";s:5:"roles";a:2:{i:0;s:5:"admin";i:1;s:6:"editor";}}token|s:6:"abc123";
?>
<?php
session_start();
// 清空當前 session(可選)
$_SESSION = [];
$encoded = 'user|a:1:{s:4:"name";s:6:"張三";}token|s:6:"abc123"';
session_decode($encoded);
print_r($_SESSION);
/*
Array
(
[user] => Array
(
[name] => 張三
)
[token] => abc123
)
*/
?>
格式:鍵名|序列化值,多個鍵值對直接拼接,無分隔符。
| 類型 | 格式 | 範例 |
|---|---|---|
| 字符串 | s:長度:"值"; | s:6:"張三";(長度為字節數) |
| 整數 | i:值; | i:1001; |
| 浮點數 | d:值; | d:3.14; |
| 布爾值 | b:1/0; | b:1; |
| NULL | N; | N; |
| 索引數組 | a:數量:{鍵值對...} | a:2:{i:0;s:5:"admin";i:1;s:6:"editor";} |
| 關聯數組 | a:數量:{鍵值對...} | a:1:{s:4:"name";s:6:"張三";} |
| 對象 | O:類名長度:"類名":屬性數:{...} | 含類名、屬性可見性標記 |
<?php
// 錯誤:未 session_start()
session_decode($data); // 警告:未初始化 session
// 正確
session_start();
session_decode($data);
?>
<?php
session_start();
$_SESSION['existing'] = 'keep';
session_decode('new|s:3:"val";');
// $_SESSION['existing'] 會被保留(不覆蓋同名鍵除外)
// 但官方文檔說明:會合併,同名鍵覆蓋
?>
若需通用序列化,請使用 serialize()/unserialize() 或 json_encode()/json_decode()。
字符串長度按字節計算,多字節字符(UTF-8 中文)長度 ≠ 字符數:
<?php
$str = '中文'; // UTF-8 佔 6 字節
echo serialize($str); // s:6:"中文"; - 標準序列化
echo session_encode(); // 同理按字節計算
?>
<?php
// 備份
session_start();
$backup = session_encode();
file_put_contents('session_backup.txt', $backup);
// 恢復(同一應用、同 PHP 版本)
session_start();
$_SESSION = [];
$backup = file_get_contents('session_backup.txt');
session_decode($backup);
?>
<?php
// 應用 A:寫入共享存儲
session_start();
$redis->set('session:' . $userId, session_encode());
// 應用 B:讀取並解碼
session_start();
$_SESSION = [];
$redisData = $redis->get('session:' . $userId);
if ($redisData) {
session_decode($redisData);
}
?>
風險:PHP 版本差異、序列化處理器差異(php/php_binary/igbinary)導致不兼容。
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| session_encode/decode | 原生、無依賴、自動處理 session.id | 格式專有、跨版本風險、無法獨立使用 | 簡單備份、同版本遷移 |
| serialize/unserialize | 標準 PHP 序列化、支援對象 | 不安全(反序列化漏洞)、體積大 | 可信數據存儲、緩存對象 |
| json_encode/decode | 通用、安全、人類可讀、跨語言 | 不支援資源/對象、無類型資訊 | API、配置、跨服務傳輸 |
| igbinary | 二進制、體積小、速度快、支援對象 | 需安裝擴展、非標準 | 高性能緩存、Session 處理器 |
| MessagePack | 跨語言、高效、Schema 支援 | 需擴展、學習成本 | 微服務通訊、高性能存儲 |
<?php
class CustomSessionHandler implements SessionHandlerInterface {
private $redis;
public function __construct(Redis $redis) {
$this->redis = $redis;
}
public function read($id) {
$data = $this->redis->get("session:$id");
if ($data) {
// 關鍵:必須返回 PHP session 格式字符串
return $data;
}
return '';
}
public function write($id, $data) {
// $data 已是 session_encode() 格式
return $this->redis->setex("session:$id", 3600, $data);
}
// ... 其他接口方法
}
// 註冊
$handler = new CustomSessionHandler($redis);
session_set_save_handler($handler, true);
session_start();
?>