docs/validators/Alnum.md
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.
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}} |
| Placeholder | Description |
|---|---|
additionalChars | Additional characters that are considered valid. |
subject | The validated input or the custom validator name (if specified). |
| Version | Description |
|---|---|
| 3.0.0 | Templates changed |
| 2.0.0 | Removed support to whitespaces by default |
| 0.3.9 | Created |