naisi_unserialize

解析 Naisi Serialization Format v1；不实例化对象或触发自动加载。

输入最多 16 MiB，根值深度为 0、最大深度为 64，数组项按所有嵌套层累计最多 65,536 项。 浮点小数点固定为 .，不受进程数字区域设置影响；支持可表示的非零次正规数及 INF、-INF、NAN。

函数签名

function naisi_unserialize(string $serialize_string): mixed

调用前提

应用入口先调用 naisi_is_ext_license_valid 并确认返回 true。只验证同一请求内已有的有效 FULL/BASIC 证明；没有证明或证明失效时立即返回失败值，不现场补做完整校验。

授权类别：LICENSE；执行模式：PROOF。许可不代替登录、租户或权限上下文；身份与数据要求见本页参数及用途说明。

参数

$serialize_string

• 类型：string
• 必填：是
• 默认值：无
• 方向：输入参数。

naisi_serialize() 产生的完整字节字符串，或符合相同受限格式的输入；拒绝对象、引用标记、声明长度不符及尾随数据。

返回值

类型：mixed

成功返回原值，b:0; 返回 false，N; 返回 null；未授权、无效输入、数值溢出或完全下溢、超限及处理失败均返回 null。合法 null 与失败无法仅凭返回值区分。

调用示例

当前请求须满足上方调用前提；请检查实际返回值和引用输出，随机结果及数据包内容以运行环境为准。

$serialize_string = 'a:3:{s:4:"name";s:9:"Naisi-947";s:6:"number";i:68;s:7:"enabled";b:0;}';

$result = naisi_unserialize($serialize_string);
var_export($result);

版本信息

• 自版本：1.0.6
• 实现模块：serialization
• 授权类别：LICENSE / PROOF
• 失败回退：null
• 文档同步：2026-10-18