萬盛學電腦網

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

PHP session_encode() 與 session_decode() 深度解析

PHP Session 序列化機制詳解

session_encode() 和 session_decode() 是 PHP 內置的 Session 數據序列化與反序列化函數,使用 PHP 專有格式(非標準 JSON/serialize)。本文深度解析其格式、用法、限制與替代方案。

一、函數原型與基本用法

session_encode() - 將當前 Session 編碼為字符串

<?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";
?>

session_decode() - 解碼字符串到 $_SESSION

<?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
)
*/
?>

二、PHP Session 序列化格式詳解

格式:鍵名|序列化值,多個鍵值對直接拼接,無分隔符。

值的序列化子格式

類型格式範例
字符串s:長度:"值";s:6:"張三";(長度為字節數)
整數i:值;i:1001;
浮點數d:值;d:3.14;
布爾值b:1/0;b:1;
NULLN;N;
索引數組a:數量:{鍵值對...}a:2:{i:0;s:5:"admin";i:1;s:6:"editor";}
關聯數組a:數量:{鍵值對...}a:1:{s:4:"name";s:6:"張三";}
對象O:類名長度:"類名":屬性數:{...}含類名、屬性可見性標記

三、關鍵限制與陷阱

1. 必須先啟動 Session

<?php
// 錯誤:未 session_start()
session_decode($data); // 警告:未初始化 session

// 正確
session_start();
session_decode($data);
?>

2. 直接覆蓋 $_SESSION 而非合併

<?php
session_start();
$_SESSION['existing'] = 'keep';

session_decode('new|s:3:"val";');
// $_SESSION['existing'] 會被保留(不覆蓋同名鍵除外)
// 但官方文檔說明:會合併,同名鍵覆蓋
?>

3. 無法直接用於非 Session 上下文

若需通用序列化,請使用 serialize()/unserialize() 或 json_encode()/json_decode()。

4. 字符編碼敏感

字符串長度按字節計算,多字節字符(UTF-8 中文)長度 ≠ 字符數:

<?php
$str = '中文'; // UTF-8 佔 6 字節
echo serialize($str);    // s:6:"中文"; - 標準序列化
echo session_encode();   // 同理按字節計算
?>

四、實際應用場景

1. Session 數據備份/遷移

<?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);
?>

2. 跨應用共享 Session(不推薦,建議用 Redis)

<?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 支援需擴展、學習成本微服務通訊、高性能存儲

六、自定義 Session 處理器中的應用

<?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();
?>
copyright © 萬盛學電腦網 all rights reserved