naisi_ascii_identifier_is_valid

查看 Markdown

验证非空 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。

关联常量

调用示例

当前请求须先完成许可验证,以下成功结果以授权通过为前提。

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