unserialize

(PHP 4, PHP 5, PHP 7)

unserialize - 从存储的表示形式创建PHP值

描述

mixed unserialize ( string $str [, array $options ] )

unserialize（）接受一个序列化变量并将其转换回PHP值。

Warning

无论allowed_classes的值如何，都不要将不受信任的用户输入传递给unserialize（）。由于对象实例化和自动加载，反序列化可能导致代码被加载和执行，恶意用户可能能够利用它。如果需要将序列化数据传递给用户，请使用安全的标准数据交换格式，如JSON（通过json_decode（）和json_encode（））。options

如果需要反序列化外部存储的序列化数据，请考虑使用hash_hmac（）进行数据验证。确保除了您之外的任何人都不会修改数据。

Parameters

str

序列化字符串。

如果被反序列化的变量是一个对象，在成功重建对象之后，PHP将自动尝试调用__wakeup（）成员函数（如果存在）。

注意：unserialize_callback_func指令 如果在反序列化期间应该实例化未定义的类，则可以设置将被调用的回调函数。（以防止获取不完整的对象“__PHP_Incomplete_Class”。）使用您的php.ini，ini_set（）或.htaccess来定义' unserialize_callback_func '。每次都应该实例化一个未定义的类，它将被调用。要禁用此功能，请清空此设置。

options

作为关联数组提供给unserialize（）的任何选项。

Name	类型	描述
allowed_classes	杂	要么接受的类名数组，要么不接受类的FALSE，要么接受所有类的TRUE。如果定义了此选项并且unserialize（）遇到了不被接受的类的对象，则该对象将被实例化为__PHP_Incomplete_Class。省略此选项与将其定义为TRUE相同：PHP将尝试实例化任何类的对象。

返回值

返回转换后的值，可以是布尔值，整数，浮点数，字符串，数组或对象。

如果传递的字符串不可反序列化，FALSE则返回并E_NOTICE发出。

Changelog

版	描述
7.1.0	现在，options（）的allowed_classes元素是严格类型的，即如果给出除数组或布尔值以外的任何内容，则unserialize（）返回FALSE并发出E_WARNING。
7.0.0	选项参数已添加。
5.6.0	通过将O：替换为C：来强制对象实例化而不调用构造函数来操作序列化数据现在将失败。

例子

示例＃1 unserialize（）示例

<?php
// Here, we use unserialize() to load session data to the
// $session_data array from the string selected from a database.
// This example complements the one described with 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)) {
    // if the execute or fetch fails, initialize to empty array
    $session_data = array();
} else {
    // we should now have the serialized data in $tmp[0].
    $session_data = unserialize($tmp[0]);
    if (!is_array($session_data)) {
        // something went wrong, initialize to empty array
        $session_data = array();
    }
}
?>

示例＃2 unserialize_callback_func示例

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

ini_set('unserialize_callback_func', 'mycallback'); // set your callback_function

function mycallback($classname) 
{
    // just include a file containing your classdefinition
    // you get $classname to figure out which classdefinition is required
}
?>

Notes

Warning

FALSE如果出现错误并且反序列化序列化FALSE值，则返回。它可以通过比较来抓住这个特殊的情况下str与序列化（假）或通过捕捉发出E_NOTICE。

描述

Parameters

返回值

Changelog

例子

Notes

See Also