萬盛學電腦網

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

PHP 序列化與反序列化深度解析:格式詳解、魔術方法、安全漏洞與實戰防禦

序列化基礎:格式規範

PHP serialize() 產生的字串可完整還原變數型別與值,**跨請求、跨進程、跨機器**傳遞 PHP 值的標準格式。

基本型別序列化格式

型別格式範例
nullN;N;
boolb:值; (1/0)b:1;
inti:值;i:123;、i:-10;
floatd:值;d:3.14;、d:1.2E+3;
strings:長度:"值";s:5:"hello"; (長度為位元組數)
arraya:數量:{鍵值對...}a:2:{i:0;s:3:"foo";i:1;s:3:"bar";}
objectO:類名長度:"類名":屬性數:{屬性...}見下

物件序列化完整範例

<?php
class User {
    public $id = 1;
    protected $name = 'Tom';
    private $secret = 'ssh';
    public static $staticProp = 'static';
}

$user = new User();
echo serialize($user);
/* 輸出 (換行僅為閱讀):
O:4:"User":3:{
    s:2:"id";i:1;
    s:7:"\0*\0name";s:3:"Tom";      // protected: \0*\0 + 屬性名
    s:9:"\0User\0secret";s:3:"ssh"; // private: \0類名\0 + 屬性名
}
註:static 屬性不序列化
*/

魔術方法:序列化生命週期鉤子

方法觸發時機用途回傳值要求
__sleep()serialize() 前清理資源、決定序列化哪些屬性、關閉連線**必須回傳屬性名陣列**,未列入者不序列化
__wakeup()unserialize() 後重建連線、初始化資源、驗證完整性無
__serialize()serialize() (PHP 7.4+)自定義序列化資料結構 (取代 __sleep)回傳關聯陣列 ['prop' => $value]
__unserialize()unserialize() (PHP 7.4+)自定義還原邏輯 (取代 __wakeup)接收關聯陣列參數

__sleep / __wakeup 實戰範例

<?php
class DatabaseConnection {
    public $dsn;
    public $username;
    public $password;
    private $pdo = null; // PDO 物件不可序列化
    
    public function __construct($dsn, $user, $pass) {
        $this->dsn = $dsn;
        $this->username = $user;
        $this->password = $pass;
        $this->connect();
    }
    
    private function connect() {
        $this->pdo = new PDO($this->dsn, $this->username, $this->password);
    }
    
    // 序列化前:關閉連線、只保存連線參數
    public function __sleep(): array {
        $this->pdo = null;
        return ['dsn', 'username', 'password']; // 僅序列化這三個
    }
    
    // 反序列化後:自動重連
    public function __wakeup(): void {
        $this->connect();
    }
}

__serialize / __unserialize 現代寫法 (PHP 7.4+ 推薦)

<?php
class UserDTO {
    public $id;
    public $name;
    public $email;
    private $passwordHash; // 敏感欄位不序列化
    
    public function __serialize(): array {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'email' => $this->email,
            // 故意排除 passwordHash
        ];
    }
    
    public function __unserialize(array $data): void {
        $this->id = $data['id'];
        $this->name = $data['name'];
        $this->email = $data['email'];
        $this->passwordHash = null; // 需重新載入或重設
    }
}

序列化安全漏洞:PHP Object Injection (POI)

核心風險:unserialize() 於**不可信資料**上執行 → 攻擊者構造惡意序列化字串 → 觸發 __wakeup/__destruct/__toString 等魔術方法 → 達成 RCE、檔案刪除、SQL注入等。

經典攻擊鏈 (Gadget Chain)

<?php
// 受害者類別 (真實框架中常見)
class FileDeleter {
    public $filename;
    public function __destruct() {
        if ($this->filename) unlink($this->filename); // 任意檔案刪除
    }
}

class Logger {
    public $writer;
    public function __destruct() {
        if ($this->writer) $this->writer->write($this->log); // 呼叫任意物件方法
    }
}

// 攻擊 Payload 構造
$payload = 'O:11:"FileDeleter":1:{s:8:"filename";s:10:"/etc/passwd";}';
// 或鏈式
$payload = 'O:6:"Logger":1:{s:6:"writer";O:11:"FileDeleter":1:{s:8:"filename";s:10:"/etc/passwd";}}';

// 受害者代碼
unserialize($_COOKIE['data']); // 直接反序列化用戶輸入 ❌

實戰防禦策略 (按推薦順序)

1. 根本對策:不要對不可信資料使用 unserialize()

<?php
// ❌ 危險
$data = unserialize($userInput);

// ✅ 安全替代:JSON
$data = json_decode($userInput, true); // 純資料結構,無程式碼執行風險

// ✅ 或:簽名驗證的序列化
function safeSerialize($data): string {
    $serialized = serialize($data);
    $hmac = hash_hmac('sha256', $serialized, SECRET_KEY);
    return $hmac . ':' . $serialized;
}

function safeUnserialize(string $payload) {
    [$hmac, $serialized] = explode(':', $payload, 2);
    if (!hash_equals($hmac, hash_hmac('sha256', $serialized, SECRET_KEY))) {
        throw new \Exception('Invalid signature');
    }
    return unserialize($serialized);
}

2. PHP 7.0+ allowed_classes 選項 (僅限制類別,不防魔術方法)

<?php
// 僅允許指定類別 (其他類別會轉為 __PHP_Incomplete_Class)
$data = unserialize($payload, ['allowed_classes' => ['UserDTO', 'OrderDTO']]);

// 禁止所有類別 (純資料結構)
$data = unserialize($payload, ['allowed_classes' => false]);

⚠️ **限制**:若允許的類別本身有危險魔術方法,仍可被利用。**非根本解決**。

3. 禁用危隐函式、開啟 Suhosin/Hardening

; php.ini
disable_functions = unserialize,exec,passthru,shell_exec,system,proc_open,popen
; Suhosin (需安裝擴充)
suhosin.executor.disable_eval = On
suhosin.request.disallow_nul = On

4. 靜態分析與運行時保護

  • PHPStan/Psalm 規則檢測 unserialize($userInput) 模式。
  • WAF/IDS 規則檢測序列化 Payload 特徵 (O::"...)。
  • 運行時 Hook (如 ruin、php-protect) 監控 unserialize 呼叫堆疊。

Session 序列化處理器風險

處理器設定值格式風險
PHP Binaryphp_serialize (PHP 5.5.4+)標準 serialize()**高** - 完整物件圖
PHP 默認phpname|s:5:"value"; (鍵值管道分隔)**中** - 可注入管道構造偽物件
IGbinaryigbinary二進位緊湊格式同 php_serialize

Session 注入攻擊場景

<?php
// 受害者: session.serialize_handler = php
// 攻擊者控制 session 資料 (如上傳進度、Session Fixation)
$_SESSION['malicious'] = '|O:11:"FileDeleter":1:{s:8:"filename";s:10:"/etc/passwd";}';
// 下次 session_start() 反序列化時觸發 __destruct

防禦:統一使用 session.serialize_handler = php_serialize + **嚴格驗證 Session 資料來源** + **簽名 Session ID**。

最佳實踐總結

  1. 資料交換首選 JSON:json_encode/decode、語言無關、無程式碼執行風險。
  2. 必須用 serialize (如緩存複雜物件):**簽名驗證 (HMAC)** + allowed_classes 白名單。
  3. Session 處理器設為 php_serialize,避免管道分隔格式注入。
  4. 敏感類別實作 __serialize/__unserialize 顯式控制序列化面,排除危險屬性/方法。
  5. 依賴注入容器避免序列化服務物件,服務應無狀態、可重建。
  6. 定期掃描 Gadget Chain (如 phpggc 工具),升級受影響套件。

總結

PHP 序列化功能強大但**極度危險**。現代開發**原則上棄用 serialize/unserialize 作為資料交換格式**,改用 JSON/MessagePack/Protobuf。若業務必須序列化物件,務必實施 **簽名驗證、類別白名單、最小權限魔術方法、靜態分析掃描** 多層防禦,將風險降至最低。

copyright © 萬盛學電腦網 all rights reserved