naisi_array_unique_integers

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

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

函数签名

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

调用前提

应用入口先调用 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。

调用示例

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

$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