unserialize() 還原物件時,若類別定義不存在,PHP 會建立 __PHP_Incomplete_Class 物件,屬性保留但無法呼叫方法。若同時啟用 spl_autoload_register(),反序列化會觸發自動載入,嘗試載入缺失類別,導致:
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.
$data = (array)unserialize($serialized);
// ['__PHP_Incomplete_Class_Name' => 'Foobar', 'foo' => '1', 'bar' => '2']
// 注意:鍵名包含特殊字符,需用花括號存取:$data['\0\0foo'] (PHP 7.2+ 可直接 $data['foo'])
class Foobar {} // 僅需存在即可
$result = unserialize($serialized); // 正常物件
echo $result->foo; // 1
缺點:污染全域命名空間、若多處反序列化不同類別需大量 Stub。
<?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);
}
}
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());
}
永不對不可信資料 (用戶輸入、Cookie、API 回傳) 直接呼叫 unserialize()。攻擊者可構造惡意序列化字串,利用魔術方法 (__wakeup, __destruct, __toString, __call) 觸發 RCE、檔案刪除、SQL 注入等。
json_encode/decode 無物件還原風險。unserialize($data, ['allowed_classes' => [AllowedClass::class]]) (PHP 7+)。hash_hmac('sha256', $data, $secret) 驗證完整性後再解序列化。__wakeup 僅做初始化,不執行副作用操作。allowed_classes 選項,PHP 8.1+ unserialize_max_depth 限制深度。unserialize() 與 spl_autoload_register() 的交互是 PHP 歷史遺留的複雜區域。現代最佳實踐:棄用 serialize 存儲/傳輸,改用 JSON/Protocol Buffers/MessagePack;若必須相容舊資料,嚴格使用 allowed_classes 白名單、簽名驗證、暫停 autoload 等多層防護,將風險降至最低。