# `naisi_serialize`

将受支持的 PHP 值编码为 Naisi Serialization Format v1。

根值深度为 0、最大深度为 64；所有嵌套数组累计最多 65,536 项，结果最多 16 MiB。
不支持对象、资源或循环引用；普通非循环引用按值展开，不保留引用身份。

## 函数签名

```php
function naisi_serialize(mixed $data): string
```

## 调用前提

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

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

## 参数

### `$data`

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

支持 null、布尔、整数、浮点（含 INF、-INF、NAN）、二进制字符串、列表和关联数组，以及指向这些类型的非循环引用。

## 返回值

类型：`string`

成功返回非空线格式字符串；未授权、不支持的类型、循环、超限或处理失败返回 ''。空字符串本身编码为 s:0:"";。

## 调用示例

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

```php
$data = 'Hello Naisi';

$result = naisi_serialize($data);
var_export($result);
```

## 版本信息

- 自版本：`1.0.6`
- 实现模块：`serialization`
- 授权类别：`LICENSE` / `PROOF`
- 失败回退：空字符串 `""`
- 文档同步：`2026-10-18`