萬盛學電腦網

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

PHP serialize 與 unserialize 完整指南:序列化儲存、傳遞、安全風險與替代方案

前言

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="">大小限制、可見性、篡改風險

安全風險:反序列化漏洞 (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原生❌中快✅ 完整 (含物件、資源參考)⚠️ 風險高
JSONjson_encode/decode✅ 標準小快⚠️ 失去型別 (無整數/浮點區分、無物件)✅ 安全
igbinary擴充套件❌小 (二進位)極快✅ 完整⚠️ 同 serialize
MessagePack擴充套件✅最小極快✅ 較完整✅ 較安全
Protocol Buffers擴充/庫✅最小極快✅ Schema 定義✅ 安全

最佳實踐建議

  1. 首選 JSON:跨語言、安全、可讀、生態系完整
  2. 高效能快取用 igbinary/MessagePack:安裝擴充,透明替換 serialize
  3. 必須用 serialize 時:
    • 設定 allowed_classes 白名單
    • 加上 HMAC 簽名防篡改
    • 類別實作 __sleep/__wakeup 或新介面控制輸出
  4. 資料庫別存序列化資料:改用 JSON 欄位 (MySQL 5.7+/PostgreSQL) 或關聯表
  5. 版本管理:序列化資料加入 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());
}
?>
copyright © 萬盛學電腦網 all rights reserved