Skip to content

Alnum.md

Latest commit

 

History

History
97 lines (72 loc) · 3.02 KB

Alnum.md

File metadata and controls

97 lines (72 loc) · 3.02 KB

Alnum

  • Alnum()
  • Alnum(string ...$additionalChars)

Validates whether the input is alphanumeric or not.

Alphanumeric is a combination of alphabetic (a-z and A-Z) and numeric (0-9) characters.

v::alnum(' ')->assert('foo 123');
// Validation passes successfully

v::alnum()->assert('foo 123');
// → "foo 123" must consist only of letters (a-z) and digits (0-9)

v::alnum()->assert('100%');
// → "100%" must consist only of letters (a-z) and digits (0-9)

v::alnum('%')->assert('100%');
// Validation passes successfully

v::alnum('%', ',')->assert('10,5%');
// Validation passes successfully

You can restrict case using the Lowercase and Uppercase validators.

v::alnum()->uppercase()->assert('example');
// → "example" must consist only of uppercase letters

Message template for this validator includes {{additionalChars}} as the string of extra chars passed as the parameter.

Templates

Alnum::TEMPLATE_STANDARD

Mode Template
default {{subject}} must consist only of letters (a-z) and digits (0-9)
inverted {{subject}} must not consist only of letters (a-z) or digits (0-9)

Alnum::TEMPLATE_EXTRA

Mode Template
default {{subject}} must consist only of letters (a-z), digits (0-9), or {{additionalChars}}
inverted {{subject}} must not consist only of letters (a-z), digits (0-9), or {{additionalChars}}

Template placeholders

Placeholder Description
additionalChars Additional characters that are considered valid.
subject The validated input or the custom validator name (if specified).

Categorization

  • Strings

Changelog

Version Description
3.0.0 Templates changed
2.0.0 Removed support to whitespaces by default
0.3.9 Created

See Also