naisi_hex_is_valid
验证非空十六进制文本及可选 ASCII 字节长度边界。
默认只允许 0-9/a-f；不接受 0x 前缀，不要求偶数位，不 trim。 只校验格式，不验证令牌、签名或摘要真实性。需要本请求已有有效许可证明。
函数签名
function naisi_hex_is_valid(string $value, int $minlength = 0, int $maxlength = 0, bool $allow_uppercase = false): bool调用前提
应用入口先调用 naisi_is_ext_license_valid 并确认返回 true。只验证同一请求内已有的有效 FULL/BASIC 证明；没有证明或证明失效时立即返回失败值，不现场补做完整校验。
授权类别：LICENSE；执行模式：PROOF。需要 DATA capability；格式校验不代替登录或业务权限检查。
参数
$value
- 类型：
string - 必填：是
- 默认值：无
- 方向：输入参数。
非空十六进制文本，例如 0abc。
$minlength
- 类型：
int - 必填：否
- 默认值：
0 - 方向：输入参数。
最小 ASCII 字节数，包含边界；0 表示不限制，负数无效。
$maxlength
- 类型：
int - 必填：否
- 默认值：
0 - 方向：输入参数。
最大 ASCII 字节数，包含边界；0 表示不限制，负数或大于 0 且小于 minlength 时无效。
$allow_uppercase
- 类型：
bool - 必填：否
- 默认值：
false - 方向：输入参数。
默认 false；true 时同时允许 A-F。
返回值
类型：bool
格式和长度均符合要求时返回 true；未授权、参数无效或验证失败返回 false。
调用示例
当前请求须先完成许可验证，以下成功结果以授权通过为前提。
var_dump(naisi_hex_is_valid('0abc', 4, 4)); // true
var_dump(naisi_hex_is_valid('0ABC', 4, 4, true)); // true
var_dump(naisi_hex_is_valid('0xabc')); // false版本信息
- 实现模块：
validation - 授权类别：
LICENSE/PROOF - 失败回退：
false - 文档同步：
2026-10-18