respect-validation/docs/validators/Named.md
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

1.4 KiB

Named

  • Named(Name|string $name, Validator $validator)

Validates the input with the given validator, and uses the custom name in the error message.

v::named('Your email', v::email())->assert('foo@example.com');
// Validation passes successfully

v::named('Your email', v::email())->assert('not an email');
// → Your email must be an email address

Here's an example of a similar code, but without using the Named validator:

v::email()->assert('not an email');
// → "not an email" must be an email address

The Named validator can be also useful when you're using Attributes and want a custom name for a specific property.

Templates

This validator does not have any templates, as it will use the template of the given validator.

Template placeholders

Placeholder Description
subject The value that you define as $name.

Categorization

  • Core
  • Display
  • Miscellaneous

Changelog

Version Description
3.0.0 Created

See Also