unserialize

(PHP 4, PHP 5, PHP 7, PHP 8)

unserialize 從已存儲的表示中創(chuàng)建 PHP 的值

說明

unserialize(string $str): mixed

unserialize() 對單一的已序列化的變量進行操作,將其轉(zhuǎn)換回 PHP 的值。

參數(shù)

str

序列化后的字符串。

若被反序列化的變量是一個對象,在成功地重新構造對象之后,PHP 會自動地試圖去調(diào)用 __wakeup() 成員函數(shù)(如果存在的話)。

注意: unserialize_callback_func 指令

如果在反序列化的時候需要實例化一個未定義類,則可以設置回調(diào)函數(shù)以供調(diào)用(以免得到的是不完整的 object “__PHP_Incomplete_Class”)??赏ㄟ^ php.ini、ini_set().htaccess 定義‘unserialize_callback_func’。每次實例化一個未定義類時它都會被調(diào)用。若要禁止這個特性,只需置空此設定。

返回值

返回的是轉(zhuǎn)換之后的值,可為 integer、float、stringarrayobject。

如果傳遞的字符串不可反序列化,則返回 false,并產(chǎn)生一個 E_NOTICE

更新日志

版本 說明
4.2.0 添加了 unserialize_callback_func 指令。

范例

示例 #1 unserialize() 例子

<?php
// 這里,我們使用 unserialize() 裝載來自數(shù)據(jù)庫的 $session_data 數(shù)組中的會話數(shù)據(jù)。
// 此例是描述 serialize() 的那個例子的補充。

$conn odbc_connect("webdb""php""chicken");
$stmt odbc_prepare($conn"SELECT data FROM sessions WHERE id = ?");
$sqldata = array($_SERVER['PHP_AUTH_USER']);
if (!
odbc_execute($stmt$sqldata) || !odbc_fetch_into($stmt$tmp)) {
    
// 如果執(zhí)行出錯或返回錯誤,則初始化為空數(shù)組
    
$session_data = array();
} else {
    
// 現(xiàn)在我們需要的是 $tmp[0] 中已序列化的數(shù)據(jù)。
    
$session_data unserialize($tmp[0]);
    if (!
is_array($session_data)) {
        
// 出錯,初始化為空數(shù)組
        
$session_data = array();
    }
}
?>

示例 #2 unserialize_callback_func 例子

<?php
$serialized_object
='O:1:"a":1:{s:5:"value";s:3:"100";}';

// unserialize_callback_func 從 PHP 4.2.0 起可用
ini_set('unserialize_callback_func''mycallback'); // 設置您的回調(diào)函數(shù)

function mycallback($classname
{
   
// 只需包含含有類定義的文件
   // $classname 指出需要的是哪一個類
}
?>

注釋

警告

如果反序列化了 false 的值,或者在過程中發(fā)生了錯誤,都會返回 false。 可以通過 strserialize(false) 進行比較,或者捕捉 E_NOTICE 錯誤來判斷這種特殊情況。

參見