respect-validation/docs/validators/Alpha.md
Henrique Moody 81310cc4d9
Rename namespace Rules to Validators
Since that namespace contains our “validators”, naming it as such makes
much more sense.
2026-01-05 17:36:35 +01:00

2.1 KiB

Alpha

  • Alpha()
  • Alpha(string ...$additionalChars)

Validates whether the input contains only alphabetic characters. This is similar to Alnum, but it does not allow numbers.

v::alpha()->isValid('some name'); // false
v::alpha(' ')->isValid('some name'); // true
v::alpha()->isValid('Cedric-Fabian'); // false
v::alpha('-')->isValid('Cedric-Fabian'); // true
v::alpha('-', '\'')->isValid('\'s-Gravenhage'); // true

You can restrict case using the Lowercase and Uppercase validators.

v::alpha()->uppercase()->isValid('example'); // false

Templates

Alpha::TEMPLATE_STANDARD

Mode Template
default {{subject}} must contain only letters (a-z)
inverted {{subject}} must not contain letters (a-z)

Alpha::TEMPLATE_EXTRA

Mode Template
default {{subject}} must contain only letters (a-z) and {{additionalChars}}
inverted {{subject}} must not contain letters (a-z) 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: