PHP session_encode 與 session_decode 深度解析

函數簡介

• session_encode()：將當前 `$_SESSION` 超全域陣列序列化為字串，格式為 名稱|序列化值 並以分號分隔。
• session_decode()：解析 session_encode() 產生的字串，還原至 `$_SESSION`。

兩者專為 PHP 原生 Session 儲存格式設計，不等同 於 serialize()/unserialize()。

session_encode 範例

<?php
session_start();
$_SESSION['bgcolor'] = 'white';
$_SESSION['fontcolor'] = 'blue';
$_SESSION['user'] = ['id' => 1, 'name' => 'Alice'];

$encoded = session_encode();
echo $encoded;
// 輸出範例：
// bgcolor|s:5:"white";fontcolor|s:4:"blue";user|a:2:{i:0;i:1;i:1;s:5:"Alice";}
?>

session_decode 範例

<?php
session_start();
$_SESSION = []; // 清空當前 session

$encoded = 'products|a:2:{i:0;s:8:"Hal 2000";i:1;s:6:"Tardis";}';
session_decode($encoded);

foreach ($_SESSION['products'] as $p) {
    echo $p . "<br>";
}
// 輸出：
// Hal 2000
// Tardis
?>

核心差異：與 serialize/unserialize 的比較

實務應用場景

1. Session 資料備份與遷移

<?php
// 備份當前 session 到資料庫/快取
$backup = session_encode();
// 還原
session_decode($backup);

2. 除錯：檢視 Session 內容

<?php
echo '<pre>';
echo htmlspecialchars(session_encode());
echo '</pre>';

3. 跨系統同步 Session（需相同 php.ini 設定）

若多台伺服器共用 Session 儲存（如 Redis），通常直接共享儲存層即可，無需手動 encode/decode。但若需透過 API 傳遞 Session 狀態，可使用此對函數。

注意事項與限制

• 必須先 session_start()：否則 `$_SESSION` 不可用，函數會失敗。
• 編碼格式依賴 php.ini：session.serialize_handler（預設 php，可選 php_binary, php_serialize）。不同處理器輸出格式不同，解碼時必須一致。
• 無法處理資源型別：Session 中不應存放資源（資料庫連線、檔案句柄等），序列化會失敗。
• 安全性：解碼不可信字串可能導致物件注入（若啟用 php_serialize 且有魔術方法），請確保資料來源可信。

總結

session_encode/decode 是 PHP Session 內部儲存格式的專用序列化工具，適合 Session 資料的備份、遷移、除錯。通用資料序列化請使用 serialize/unserialize 或 json_encode/decode。