naisi_dict_get_item_index_by_key
将模块字典 key 映射为整数索引；缺失时返回 $default。
函数签名
function naisi_dict_get_item_index_by_key(string $dict_key, string $item_key, int $default = -1): int调用前提
应用入口先调用 naisi_is_ext_license_valid 并确认返回 true。只验证同一请求内已有的有效 FULL/BASIC 证明；没有证明或证明失效时立即返回失败值，不现场补做完整校验。
授权类别：DICTIONARY_CONTEXTUAL；执行模式：PROOF。许可不代替登录、租户或权限上下文；身份与数据要求见本页参数及用途说明。
参数
$dict_key
- 类型：
string - 必填：是
- 默认值：无
- 方向：输入参数。
需要查询的字典稳定键名。
$item_key
- 类型：
string - 必填：是
- 默认值：无
- 方向：输入参数。
可选的字典项目分组键；null 返回整个字典项目数组。
$default
- 类型：
int - 必填：否
- 默认值：
-1 - 方向：输入参数。
查找不到目标值时返回的默认值。
返回值
类型：int
返回匹配的整数索引；未找到时返回调用方指定的默认索引。
调用示例
当前请求须满足上方调用前提；请检查实际返回值和引用输出，随机结果及数据包内容以运行环境为准。
$dict_key = 'order_status';
$item_key = 'pending';
$default = -1;
$result = naisi_dict_get_item_index_by_key($dict_key, $item_key, $default);
var_dump($result);版本信息
- 自版本：
1.0.6 - 实现模块：
dictionary - 授权类别：
DICTIONARY_CONTEXTUAL/PROOF - 失败回退：
-1 - 文档同步：
2026-10-18