# `naisi_array_unique_integers`

过滤数组中的 PHP 空值、按 array_unique 默认字符串语义去重，并重新建立连续整数索引。

$convert_to_integer 为 true 时，先对每个元素执行与 intval() 相同的转换，再过滤转换后
的零值。函数保持第一个唯一值的出现顺序，并要求当前请求已经建立有效 BASIC 或 FULL
许可证明。

## 函数签名

```php
function naisi_array_unique_integers(array $values, bool $convert_to_integer = false): array|false
```

## 调用前提

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

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

## 参数

### `$values`

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

需要过滤和去重的输入数组。false、null、整数 0、浮点 0、空字符串、字符串 "0" 和空数组会按 PHP array_filter() 无回调规则移除；返回结果不保留原始键。

### `$convert_to_integer`

- 类型：`bool`
- 必填：否
- 默认值：`false`
- 方向：输入参数。

为 true 时先逐项执行 PHP intval() 等价转换，随后移除转换得到的 0、按整数值去重并重建索引；默认 false。

## 返回值

类型：`array|false`

成功时返回从索引 0 开始的唯一非空值数组，并保留各唯一值第一次出现的顺序；未建立有效 BASIC/FULL 请求证明、输入无法安全转换或内部处理失败时返回 false。

## 调用示例

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

```php
$values = [0, false, null, 1, '1', '01', 2, 2, '', '0', 3];
$convert_to_integer = false;

$result = naisi_array_unique_integers($values, $convert_to_integer);
var_export($result);
```

## 版本信息

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