PHP serialize() 產生的字串可完整還原變數型別與值,**跨請求、跨進程、跨機器**傳遞 PHP 值的標準格式。
| 型別 | 格式 | 範例 |
|---|---|---|
| null | N; | N; |
| bool | b:值; (1/0) | b:1; |
| int | i:值; | i:123;、i:-10; |
| float | d:值; | d:3.14;、d:1.2E+3; |
| string | s:長度:"值"; | s:5:"hello"; (長度為位元組數) |
| array | a:數量:{鍵值對...} | a:2:{i:0;s:3:"foo";i:1;s:3:"bar";} |
| object | O:類名長度:"類名":屬性數:{屬性...} | 見下 |
<?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) | 接收關聯陣列參數 |
<?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();
}
}
<?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; // 需重新載入或重設
}
}
核心風險:unserialize() 於**不可信資料**上執行 → 攻擊者構造惡意序列化字串 → 觸發 __wakeup/__destruct/__toString 等魔術方法 → 達成 RCE、檔案刪除、SQL注入等。
<?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']); // 直接反序列化用戶輸入 ❌
<?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);
}
allowed_classes 選項 (僅限制類別,不防魔術方法)<?php
// 僅允許指定類別 (其他類別會轉為 __PHP_Incomplete_Class)
$data = unserialize($payload, ['allowed_classes' => ['UserDTO', 'OrderDTO']]);
// 禁止所有類別 (純資料結構)
$data = unserialize($payload, ['allowed_classes' => false]);
⚠️ **限制**:若允許的類別本身有危險魔術方法,仍可被利用。**非根本解決**。
; php.ini
disable_functions = unserialize,exec,passthru,shell_exec,system,proc_open,popen
; Suhosin (需安裝擴充)
suhosin.executor.disable_eval = On
suhosin.request.disallow_nul = On
unserialize($userInput) 模式。O::"...)。ruin、php-protect) 監控 unserialize 呼叫堆疊。| 處理器 | 設定值 | 格式 | 風險 |
|---|---|---|---|
| PHP Binary | php_serialize (PHP 5.5.4+) | 標準 serialize() | **高** - 完整物件圖 |
| PHP 默認 | php | name|s:5:"value"; (鍵值管道分隔) | **中** - 可注入管道構造偽物件 |
| IGbinary | igbinary | 二進位緊湊格式 | 同 php_serialize |
<?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**。
json_encode/decode、語言無關、無程式碼執行風險。allowed_classes 白名單。phpggc 工具),升級受影響套件。PHP 序列化功能強大但**極度危險**。現代開發**原則上棄用 serialize/unserialize 作為資料交換格式**,改用 JSON/MessagePack/Protobuf。若業務必須序列化物件,務必實施 **簽名驗證、類別白名單、最小權限魔術方法、靜態分析掃描** 多層防禦,將風險降至最低。