mirror of https://github.com/Respect/Validation.git synced 2026-03-14 22:35:45 +01:00

Alexandre Gomes Gaigalas 16148e9593 Standardize and improve validation message templates

- Remove redundant "valid" prefix:
   Date, DateTime, DateTimeDiff, Domain, Email, Iban, Imei, Ip, Isbn, Json, LanguageCode, LeapDate, LeapYear, Luhn, MacAddress, NfeAccessKey, Nif, Nip, Pesel, Phone, Pis, PolishIdCard, PostalCode, Roman, Slug, Tld, Url, Uuid, Version.

 - Remove redundant "value" suffix
   ArrayVal, BoolVal, Countable, FloatVal, IntVal, IterableVal, NumericVal, ScalarVal, StringVal.

 - Standardize "consist only of" phrasing
   Alnum, Alpha, Cntrl, Consonant, Digit, Graph, Lowercase, Printable, Punct, Space, Spaced, Uppercase, Vowel, Xdigit.

 - Improve file accessibility messages
   Directory, Executable, File, Image, Readable, SymbolicLink, Writable.

 - Improve grammar and article usage
   CreditCard, Extension, Mimetype, Regex, Size.

2026-02-03 19:58:55 +00:00

2.7 KiB

Raw Blame History

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(' ')->assert('some name');
// Validation passes successfully

v::alpha()->assert('some name');
// → "some name" must consist only of letters (a-z)

v::alpha()->assert('Cedric-Fabian');
// → "Cedric-Fabian" must consist only of letters (a-z)

v::alpha('-')->assert('Cedric-Fabian');
// Validation passes successfully

v::alpha('-', '\'')->assert('\'s-Gravenhage');
// Validation passes successfully

You can restrict case using the Lowercase and Uppercase validators.

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

Templates

`Alpha::TEMPLATE_STANDARD`

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

`Alpha::TEMPLATE_EXTRA`

Mode	Template
`default`	{{subject}} must consist only of letters (a-z) or {{additionalChars}}
`inverted`	{{subject}} must not consist only of 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
3.0.0	Templates changed
2.0.0	Removed support to whitespaces by default
0.3.9	Created

2.7 KiB Raw Blame History