正常序列化字符串 unserialize() 返回 false,常見於跨系統、跨數據庫遷移、編碼轉換場景。
<?php
$str = 'a:9:{s:4:"time";i:1405306402;s:4:"name";s:6:"新晨";s:5:"url";s:1:"-";s:4:"word";s:1:"-";s:5:"rpage";s:29:"https://www.baidu.com/test.html";s:5:"cpage";s:1:"-";s:2:"ip";s:15:"117.151.180.150";s:7:"ip_city";s:31:"中國北京市 北京市移動";s:4:"miao";s:1:"5";}';
var_dump(unserialize($str)); // bool(false)
?>
PHP 序列化格式中字符串長度標識 s:長度:"值" 的 長度單位是字節,而非字符數。
錯誤點:
s:5:"url" → 實際 "url" 3 字節,應為 s:3:"url"s:29:"https://www.baidu.com/test.html" → 實際 30 字節,應為 s:30:"..."核心原因:序列化時的編碼環境與反序列化時的編碼環境不一致,導致字節長度計算偏差。
<?php
/**
* 修復序列化字符串長度不匹配
* 適用於 UTF-8 環境
*/
function mb_unserialize($serial_str) {
// 1. 修正字符串長度:s:長度:"值" -> 實際字節長度
$serial_str = preg_replace_callback(
'!s:(\d+):"(.*?)";!s',
function($m) {
return 's:' . strlen($m[2]) . ':"' . $m[2] . '";';
},
$serial_str
);
// 2. 移除可能干擾的 \r
$serial_str = str_replace("\r", '', $serial_str);
return @unserialize($serial_str);
}
/** ASCII/單字節編碼環境修復 */
function asc_unserialize($serial_str) {
$serial_str = preg_replace_callback(
'!s:(\d+):"(.*?)";!s',
function($m) {
return 's:' . strlen($m[2]) . ':"' . $m[2] . '";';
},
$serial_str
);
$serial_str = str_replace("\r", '', $serial_str);
return @unserialize($serial_str);
}
?>
<?php
header('Content-Type: text/html; charset=utf-8');
$str = 'a:9:{s:4:"time";i:1405306402;s:4:"name";s:6:"新晨";s:5:"url";s:1:"-";s:4:"word";s:1:"-";s:5:"rpage";s:29:"https://www.baidu.com/test.html";s:5:"cpage";s:1:"-";s:2:"ip";s:15:"117.151.180.150";s:7:"ip_city";s:31:"中國北京市 北京市移動";s:4:"miao";s:1:"5";}';
echo "原始 unserialize: ";
var_dump(unserialize($str)); // bool(false)
echo "mb_unserialize 修復後: ";
var_dump(mb_unserialize($str));
/* 輸出:
array(9) {
["time"]=> int(1405306402)
["name"]=> string(6) "新晨"
["url"]=> string(1) "-"
["word"]=> string(1) "-"
["rpage"]=> string(30) "https://www.baidu.com/test.html"
["cpage"]=> string(1) "-"
["ip"]=> string(15) "117.151.180.150"
["ip_city"]=> string(31) "中國北京市 北京市移動"
["miao"]=> string(1) "5"
}
*/
?>
| 場景 | 原因 | 預防 |
|---|---|---|
| MySQL latin1 表存儲 UTF-8 序列化數據 | 讀取時按 latin1 解碼,字節長度改變 | 表/連接統一 utf8mb4,或用 BLOB 存儲 |
| 跨系統 API 傳輸 | 發送端 UTF-8,接收端 GBK/ISO-8859-1 | 協議規範 UTF-8,或 Base64 編碼傳輸 |
| 文件讀寫編碼不一致 | fwrite UTF-8,fread 按系統默認編碼 | 明確指定編碼,或用 JSON 替代 serialize |
| 手動拼接/修改序列化字符串 | 未同步更新長度標識 | 嚴禁手動修改,需反序列化→修改→重新序列化 |
強烈建議棄用 serialize/unserialize,改用 JSON:
__wakeup/__destruct 鏈)json_encode/decode 為 C 實現)JSON_THROW_ON_ERROR 異常處理(PHP 7.3+)<?php
// 安全、通用、高效
$data = ['name' => '新晨', 'url' => 'https://example.com'];
$json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
$restored = json_decode($json, true); // 關聯數組
?>
<?php
// 1. 僅允許白名單類
$allowed = ['UserDTO', 'OrderVO'];
$unserialized = @unserialize($data, ['allowed_classes' => $allowed]); // PHP 7.0+
// 2. 簽名驗證防篡改
function signed_serialize($data, $secret) {
$serialized = serialize($data);
return $serialized . '.' . hash_hmac('sha256', $serialized, $secret);
}
function signed_unserialize($signed, $secret) {
list($serialized, $sig) = explode('.', $signed, 2);
if (!hash_equals(hash_hmac('sha256', $serialized, $secret), $sig)) {
throw new Exception('簽名驗證失敗');
}
return unserialize($serialized, ['allowed_classes' => $allowed]);
}
?>
序列化數據的編碼一致性是跨系統數據交換的核心痛點。現代架構應全面遷移至 JSON + 簽名驗證,從根源消除此類問題。