萬盛學電腦網

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

PHP unserialize 返回 false 解決方案:編碼不一致導致長度錯誤的修復

一、問題現象

正常序列化字符串 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:"..."
  • 中文字符:「新晨」UTF-8 佔 6 字節(每字 3 字節),但序列化時按其他編碼(如 Latin1/GBK)計算長度

核心原因:序列化時的編碼環境與反序列化時的編碼環境不一致,導致字節長度計算偏差。

三、修復函數:動態重算字符串長度

<?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
手動拼接/修改序列化字符串未同步更新長度標識嚴禁手動修改,需反序列化→修改→重新序列化

六、現代化替代方案:JSON

強烈建議棄用 serialize/unserialize,改用 JSON:

  • ✅ 跨語言、跨平台、編碼無關(UTF-8 標準)
  • ✅ 人類可讀、易調試、易日誌分析
  • ✅ 無代碼執行風險(unserialize 可實例化對象觸發 __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); // 關聯數組
?>

七、不得不使用 serialize 時的安全加固

<?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 + 簽名驗證,從根源消除此類問題。

copyright © 萬盛學電腦網 all rights reserved