萬盛學電腦網

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

PHP Unserialize 與 Autoload 交互陷阱:不完整類別與自動載入衝突解決方案

問題背景

unserialize() 還原物件時,若類別定義不存在,PHP 會建立 __PHP_Incomplete_Class 物件,屬性保留但無法呼叫方法。若同時啟用 spl_autoload_register(),反序列化會觸發自動載入,嘗試載入缺失類別,導致:

  • 載入失敗拋出例外中斷流程
  • 載入錯誤版本類別 (介面不符)
  • 第三方庫的 autoload 邏輯不當 (如 include "/path/{$class}.php" 找不到檔案)

現象演示

<?php
// 1. 無類別定義時反序列化
$serialized = 'O:6:"Foobar":2:{s:3:"foo";s:1:"1";s:3:"bar";s:1:"2";}';
$result = unserialize($serialized);
var_dump($result);
/*
object(__PHP_Incomplete_Class)#1 (3) {
  ["__PHP_Incomplete_Class_Name"]=> string(6) "Foobar"
  ["foo"]=> string(1) "1"
  ["bar"]=> string(1) "2"
}
*/

// 2. 嘗試存取屬性 → 致命錯誤
// echo $result->foo; 
// Fatal error: The script tried to execute a method or access a property of an incomplete object.

解決方案對比

方案 A:強制轉陣列 (快速取值,不需類別)

$data = (array)unserialize($serialized);
// ['__PHP_Incomplete_Class_Name' => 'Foobar', 'foo' => '1', 'bar' => '2']
// 注意:鍵名包含特殊字符,需用花括號存取:$data['\0\0foo'] (PHP 7.2+ 可直接 $data['foo'])

方案 B:臨時定義 Stub 類別 (最簡單)

class Foobar {} // 僅需存在即可
$result = unserialize($serialized); // 正常物件
echo $result->foo; // 1

缺點:污染全域命名空間、若多處反序列化不同類別需大量 Stub。

方案 C:暫時停用 Autoload (推薦,不污染命名空間)

<?php
// 註冊有問題的 autoload
spl_autoload_register(function($class) {
  include "/path/to/{$class}.php"; // 找不到會拋錯
});

$serialized = 'O:6:"Foobar":2:{s:3:"foo";s:1:"1";s:3:"bar";s:1:"2";}';

// 1. 保存並註銷所有 autoload 函式
$autoloaders = spl_autoload_functions();
foreach ($autoloaders as $loader) {
  spl_autoload_unregister($loader);
}

try {
  // 2. 安全反序列化 (不觸發 autoload)
  $result = (array)unserialize($serialized); // 或直接 unserialize() 若只取屬性
  var_dump($result);
} finally {
  // 3. 恢復 autoload
  foreach ($autoloaders as $loader) {
    spl_autoload_register($loader);
  }
}

方案 D:自定義 unserialize_callback_func (PHP 專用配置)

ini_set('unserialize_callback_func', 'myUnserializeCallback');

function myUnserializeCallback($className) {
  // 僅處理特定前綴類別,避免干擾其他 autoload
  if (str_starts_with($className, 'MyApp\\Legacy\\')) {
    require __DIR__ . '/legacy/' . str_replace('\\', '/', $className) . '.php';
  }
  // 其他類別不處理,讓標準 autoload 處理或生成 Incomplete_Class
}

最佳實踐:封裝安全反序列化服務

<?php
class SafeUnserializer {
  private array $allowedClasses = [];
  private ?callable $originalCallback = null;
  
  public function __construct(array $allowedClasses = []) {
    $this->allowedClasses = $allowedClasses;
  }
  
  public function unserialize(string $data): mixed {
    // 1. 白名單模式:僅允許指定類別還原
    $allowed = $this->allowedClasses ? implode(',', $this->allowedClasses) : false;
    
    // 2. 暫時設定 callback (PHP 7+ 支援 allowed_classes 選項更簡單)
    if (PHP_VERSION_ID >= 70000) {
      return @unserialize($data, ['allowed_classes' => $this->allowedClasses]);
    }
    
    // PHP 5.x 相容做法
    $this->originalCallback = ini_get('unserialize_callback_func');
    ini_set('unserialize_callback_func', [$this, 'callback']);
    
    try {
      return @unserialize($data);
    } finally {
      ini_set('unserialize_callback_func', $this->originalCallback ?? '');
    }
  }
  
  private function callback(string $class): void {
    if (!in_array($class, $this->allowedClasses, true)) {
      throw new UnexpectedValueException("不允許反序列化類別: {$class}");
    }
    // 這裡可自動載入允許的類別
    if (!class_exists($class, false) && !interface_exists($class, false)) {
      // 觸發標準 autoload
    }
  }
}

// 使用
$unserializer = new SafeUnserializer([User::class, Order::class, Product::class]);
try {
  $object = $unserializer->unserialize($untrustedData);
} catch (UnexpectedValueException $e) {
  // 記錄安全事件、拒絕處理
  log_security_alert($e->getMessage());
}

安全警示:反序列化漏洞 (Object Injection)

永不對不可信資料 (用戶輸入、Cookie、API 回傳) 直接呼叫 unserialize()。攻擊者可構造惡意序列化字串,利用魔術方法 (__wakeup, __destruct, __toString, __call) 觸發 RCE、檔案刪除、SQL 注入等。

防護清單

  1. 首選 JSON:json_encode/decode 無物件還原風險。
  2. 若必須用 serialize:unserialize($data, ['allowed_classes' => [AllowedClass::class]]) (PHP 7+)。
  3. 簽名驗證:hash_hmac('sha256', $data, $secret) 驗證完整性後再解序列化。
  4. 避免實作敏感魔術方法:__wakeup 僅做初始化,不執行副作用操作。
  5. 升級 PHP:PHP 7+ 內建 allowed_classes 選項,PHP 8.1+ unserialize_max_depth 限制深度。

結語

unserialize() 與 spl_autoload_register() 的交互是 PHP 歷史遺留的複雜區域。現代最佳實踐:棄用 serialize 存儲/傳輸,改用 JSON/Protocol Buffers/MessagePack;若必須相容舊資料,嚴格使用 allowed_classes 白名單、簽名驗證、暫停 autoload 等多層防護,將風險降至最低。

copyright © 萬盛學電腦網 all rights reserved