前言
serialize() 將 PHP 值 (陣列、物件、純量) 轉為可儲存字串,unserialize() 還原。本文詳細說明語法、用途、資料結構、安全風險 (反序列化漏洞)、IG 二進位協定、與 JSON/MessagePack 對比。
基本語法與資料結構
<?php
$original = [
'id' => 123,
'name' => '張三',
'tags' => ['php', 'laravel'],
'active' => true,
'score' => 98.5,
'metadata' => null,
];
// 序列化
$serialized = serialize($original);
/*
輸出字串結構:
a:6:{ // 陣列 6 個元素
i:123; // 整數 123
s:4:"name";s:6:"張三"; // 鍵 "name" (4字元) => 字串 "張三" (6位元組)
s:4:"tags";a:2:{ // 鍵 "tags" => 陣列 2 元素
i:0;s:3:"php"; // 索引 0 => "php"
i:1;s:7:"laravel"; // 索引 1 => "laravel"
}
s:6:"active";b:1; // 布林 true
s:5:"score";d:98.5; // 浮點數
s:8:"metadata";N; // NULL
}
*/
// 反序列化
$restored = unserialize($serialized);
var_dump($restored === $original); // true (值相等,但非同一物件)
?>
物件序列化:__sleep / __wakeup / __serialize / __unserialize
<?php
class User {
public $id;
public $name;
private $passwordHash; // 敏感資料不應序列化
private $pdo; // 資源無法序列化
public $createdAt;
public function __construct($id, $name, $password) {
$this->id = $id;
$this->name = $name;
$this->passwordHash = password_hash($password, PASSWORD_DEFAULT);
$this->createdAt = new DateTime();
// $this->pdo = new PDO(...); // 實際連線
}
// PHP 传统:指定要序列化的屬性名稱陣列
public function __sleep() {
return ['id', 'name', 'createdAt']; // 排除 passwordHash, pdo
}
// 反序列化後重新初始化
public function __wakeup() {
$this->passwordHash = ''; // 重新登入時重設
// $this->pdo = new PDO(...); // 重新連線
}
}
// PHP 7.4+ 新介面:更精確控制
class UserV2 {
// ... 相同屬性
public function __serialize(): array {
return [
'id' => $this->id,
'name' => $this->name,
'createdAt' => $this->createdAt->format('c'),
];
}
public function __unserialize(array $data): void {
$this->id = $data['id'];
$this->name = $data['name'];
$this->createdAt = new DateTime($data['createdAt']);
$this->passwordHash = '';
}
}
?>
常見用途場景
| 場景 | 說明 | 注意事項 |
| Session 儲存物件 | PHP 預設 session 使用 serialize | 類別定義必須在 session_start() 前載入 |
| 快取複雜資料結構 | Redis/Memcached 儲存序列化字串 | 考慮 JSON/MessagePack 更通用 |
| 跨程序傳遞 (CLI、Queue) | 進程間傳遞 PHP 值 | 版本一致性、類別定義同步 |
| 資料庫儲存陣列/物件 | 單欄位存複雜結構 | 查詢/索引困難,謹慎使用 |
| 表單隱藏欄位傳遞陣列 | <input type="hidden" value="= htmlspecialchars(serialize($arr)) ?>"> | 大小限制、可見性、篡改風險 |
安全風險:反序列化漏洞 (Object Injection)
<?php
// 危險範例:不可信輸入直接 unserialize
// 攻擊者構造惡意序列化字串,利用 __wakeup/__destruct/__toString 魔術方法執行任意代碼
// 例如:O:8:"User":2:{s:2:"id";i:1;s:4:"name";O:10:"EvilClass":0:{}}
// 防護措施:
// 1. 絕對不要 unserialize 使用者輸入!
// 2. 必須用時:PHP 7.0+ allowed_classes 選項
$data = unserialize($input, ['allowed_classes' => ['User', 'Product']]); // 僅允許白名單類別
// PHP 7.4+ 更嚴格:allowed_classes => false 禁止所有物件
// 3. 簽名驗證:序列化時附加 HMAC
function safeSerialize($data, $secret) {
$serialized = serialize($data);
$hmac = hash_hmac('sha256', $serialized, $secret);
return $hmac . ':' . $serialized;
}
function safeUnserialize($signed, $secret, $allowedClasses = ['User']) {
[$hmac, $serialized] = explode(':', $signed, 2);
if (!hash_equals($hmac, hash_hmac('sha256', $serialized, $secret))) {
throw new Exception('簽名驗證失敗');
}
return unserialize($serialized, ['allowed_classes' => $allowedClasses]);
}
?>
序列化格式對比
| 格式 | PHP 支援 | 跨語言 | 體積 | 速度 | 型別保真 | 安全性 |
| serialize | 原生 | ❌ | 中 | 快 | ✅ 完整 (含物件、資源參考) | ⚠️ 風險高 |
| JSON | json_encode/decode | ✅ 標準 | 小 | 快 | ⚠️ 失去型別 (無整數/浮點區分、無物件) | ✅ 安全 |
| igbinary | 擴充套件 | ❌ | 小 (二進位) | 極快 | ✅ 完整 | ⚠️ 同 serialize |
| MessagePack | 擴充套件 | ✅ | 最小 | 極快 | ✅ 較完整 | ✅ 較安全 |
| Protocol Buffers | 擴充/庫 | ✅ | 最小 | 極快 | ✅ Schema 定義 | ✅ 安全 |
最佳實踐建議
- 首選 JSON:跨語言、安全、可讀、生態系完整
- 高效能快取用 igbinary/MessagePack:安裝擴充,透明替換 serialize
- 必須用 serialize 時:
- 設定
allowed_classes 白名單
- 加上 HMAC 簽名防篡改
- 類別實作
__sleep/__wakeup 或新介面控制輸出
- 資料庫別存序列化資料:改用 JSON 欄位 (MySQL 5.7+/PostgreSQL) 或關聯表
- 版本管理:序列化資料加入 version 欄位,支援向前/向後相容
除錯技巧
<?php
// 查看序列化結構不執行反序列化
function inspectSerialize($str) {
// 簡易解析器或使用工具:https://github.com/paragonie/serialize-parser
echo "長度: " . strlen($str) . "<br>";
echo "開頭型別標識: " . $str[0] . "<br>"; // a=array, o=object, s=string, i=int, d=double, b=bool, N=null
}
// 反序列化錯誤捕獲
try {
$data = @unserialize($input);
if ($data === false && $input !== 'b:0;') { // false 本身序列化為 b:0;
throw new Exception('反序列化失敗');
}
} catch (Exception $e) {
error_log("Unserialize error: " . $e->getMessage());
}
?>