igbinary_unserialize

(PECL igbinary >= 1.1.1)

igbinary_unserializeigbinary_serialize() 创建一个 PHP 值,用于存储表示形式

描述

igbinary_unserialize(string $str): mixed

igbinary_unserialize()igbinary_serialize() 获取单个序列化变量,并将其转换回 PHP 值。

警告

不可信任的用户输入不能传递给 igbinary_unserialize()。由于对象实例化和自动加载,反序列化可能会导致代码被加载和执行,恶意用户可能会利用此漏洞。相反,应该使用安全的标准数据交换格式,例如 JSON(通过 json_decode()json_encode()),如果需要将序列化数据传递给客户端。

如果需要反序列化外部存储的序列化数据,可以使用 hash_hmac() 进行数据验证。确保没有人篡改数据非常重要。

警告

igbinary 序列化格式无法区分相同值的不同引用组。当反序列化时,对给定值的任何 PHP 引用都被视为同一引用组的一部分,即使它们在序列化时是不同引用组的一部分。

参数

str

igbinary_serialize() 生成的序列化字符串。

如果要反序列化的值是 object,igbinary 在成功重建对象后将自动尝试调用 __unserialize()__wakeup() 方法(如果存在)。

注意: unserialize_callback_func 指令

可以设置一个回调函数,如果在反序列化期间应该实例化一个未定义的类,则会调用该函数。(以防止获得不完整的 object __PHP_Incomplete_Class。)可以使用 php.iniini_set().htaccess 来定义 unserialize_callback_func。每次应该实例化一个未定义的类时,都会调用它。要禁用此功能,应清空此设置。

返回值

返回转换后的值,可以是 boolintfloatstringarrayobjectnull

如果传递的字符串无法反序列化,则返回 false 并发出 E_NOTICEE_WARNING

错误/异常

对象可能会在它们的反序列化处理程序中抛出 Throwable

备注

警告

nullfalse 在出现错误和反序列化已序列化的 nullfalse 值时都会被返回。可以通过将 strigbinary_serialize(null)igbinary_serialize(false) 进行比较,或者通过捕获发出的 E_NOTICE 来捕获这种情况。

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top