# `naisi_unserialize`

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

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

## 函数签名

```php
function naisi_unserialize(string $serialize_string): mixed
```

## 调用前提

应用入口先调用 [naisi_is_ext_license_valid](/web/developers/naisilib/naisi-is-ext-license-valid) 并确认返回 `true`。只验证同一请求内已有的有效 FULL/BASIC 证明；没有证明或证明失效时立即返回失败值，不现场补做完整校验。

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

## 参数

### `$serialize_string`

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

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

## 返回值

类型：`mixed`

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

## 调用示例

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

```php
$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`