(PHP 4, PHP 5, PHP 7, PHP 8)
unserialize — 從已存儲的表示中創(chuàng )建 PHP 的值
str
序列化后的字符串。
若被反序列化的變量是一個(gè)對象,在成功地重新構造對象之后,PHP 會(huì )自動(dòng)地試圖去調用 __wakeup() 成員函數(如果存在的話(huà))。
注意: unserialize_callback_func 指令
如果在反序列化的時(shí)候需要實(shí)例化一個(gè)未定義類(lèi),則可以設置回調函數以供調用(以免得到的是不完整的 object “__PHP_Incomplete_Class”)??赏ㄟ^(guò) php.ini、ini_set() 或 .htaccess 定義‘unserialize_callback_func’。每次實(shí)例化一個(gè)未定義類(lèi)時(shí)它都會(huì )被調用。若要禁止這個(gè)特性,只需置空此設定。
返回的是轉換之后的值,可為 integer、float、string、array 或 object。
如果傳遞的字符串不可反序列化,則返回 false
,并產(chǎn)生一個(gè) E_NOTICE
。
版本 | 說(shuō)明 |
---|---|
4.2.0 | 添加了 unserialize_callback_func 指令。 |
示例 #1 unserialize() 例子
<?php
// 這里,我們使用 unserialize() 裝載來(lái)自數據庫的 $session_data 數組中的會(huì )話(huà)數據。
// 此例是描述 serialize() 的那個(gè)例子的補充。
$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)) {
// 如果執行出錯或返回錯誤,則初始化為空數組
$session_data = array();
} else {
// 現在我們需要的是 $tmp[0] 中已序列化的數據。
$session_data = unserialize($tmp[0]);
if (!is_array($session_data)) {
// 出錯,初始化為空數組
$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'); // 設置您的回調函數
function mycallback($classname)
{
// 只需包含含有類(lèi)定義的文件
// $classname 指出需要的是哪一個(gè)類(lèi)
}
?>
如果反序列化了 false
的值,或者在過(guò)程中發(fā)生了錯誤,都會(huì )返回 false
。
可以通過(guò) str
和 serialize(false)
進(jìn)行比較,或者捕捉 E_NOTICE
錯誤來(lái)判斷這種特殊情況。