respect-validation/docs/validators/Alnum.md
Alexandre Gomes Gaigalas bd48bdcda4 Lint Changelog format in validator docs
Introduces a Markdown linter for checking the Changelog format.

"See Also" was transformed into a section to make it easier to
handle it with the `Content` class. The "Related" linter was
simplified to reflect that change too.

An additional "alignment" parameter was added to markdown table
generators, allowing the padding and headers to be explicitly
marked with a specific left (-1), middle (0) or right(1)
alignment.

Existing files were fixed using the `fix` option after the
changes.
2026-01-26 19:11:00 +00:00

2.8 KiB

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');
// → "foo 123" must contain only letters (a-z) and digits (0-9)

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

v::alnum()->assert('100%');
// → "100%" must contain only 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 contain only 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 contain only letters (a-z) and digits (0-9)
inverted {{subject}} must not contain letters (a-z) or digits (0-9)

Alnum::TEMPLATE_EXTRA

Mode Template
default {{subject}} must contain only letters (a-z), digits (0-9), and {{additionalChars}}
inverted {{subject}} must not contain 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
2.0.0 Removed support to whitespaces by default
0.3.9 Created

See Also