naisi_ascii_identifier_is_valid
验证非空 ASCII 字母、数字、下划线或短横线组成的标识串。
允许数字开头以及单个 - 或 _;不 trim,不验证标识的可信性或权限。 与 NAISI_VALIDATOR_ASCII_IDENTIFIER 选择器共享规则,参数顺序为最小长度、最大长度。 例如 naisi_ascii_identifier_is_valid('a_B-1', 1, 128)。需要本请求已有有效许可证明。
函数签名
function naisi_ascii_identifier_is_valid(string $value, int $minlength = 0, int $maxlength = 0): bool
调用前提
应用入口先调用 naisi_is_ext_license_valid 并确认返回 true。只验证同一请求内已有的有效 FULL/BASIC 证明;没有证明或证明失效时立即返回失败值,不现场补做完整校验。
授权类别:LICENSE;执行模式:PROOF。需要 DATA capability;格式校验不代替登录或业务权限检查。
参数
$value
- 类型:
string - 必填:是
- 默认值:无
- 方向:输入参数。
仅含 A-Z/a-z/0-9/_/- 的非空文本。
$minlength
- 类型:
int - 必填:否
- 默认值:
0 - 方向:输入参数。
最小 ASCII 字节数,包含边界;0 表示不限制,负数无效。
$maxlength
- 类型:
int - 必填:否
- 默认值:
0 - 方向:输入参数。
最大 ASCII 字节数,包含边界;0 表示不限制,负数或大于 0 且小于 minlength 时无效。
返回值
类型:bool
格式和长度均符合要求时返回 true;未授权、参数无效、依赖不可用或验证失败返回 false。
关联常量
NAISI_VALIDATOR_ASCII_IDENTIFIER=29— 非空 ASCII 字母、数字、下划线或短横线,允许数字开头。
调用示例
当前请求须先完成许可验证,以下成功结果以授权通过为前提。
var_dump(naisi_ascii_identifier_is_valid('a_B-1', 1, 128)); // true
var_dump(naisi_ascii_identifier_is_valid('-', 1, 128)); // true
var_dump(naisi_ascii_identifier_is_valid('a b')); // false
版本信息
- 实现模块:
validation - 授权类别:
LICENSE/PROOF - 失败回退:
false - 文档同步:
2026-10-18