respect-validation/docs/validators/Named.md
Henrique Moody 882f24b6b8
Create "Masked" validator
The Masked validator decorates other validators to mask sensitive input
values in error messages while still validating the original unmasked
data.

This validator is essential for applications handling sensitive
information such as passwords, credit cards, or email addresses. Without
it, users would need to implement a custom layer between Validation and
the end user to prevent PII from appearing in error messages or logs.

With Masked, sensitive data protection is built directly into the
validation workflow with no additional abstraction required.

Assisted-by: Claude Code (Opus 4.5)
2026-01-30 21:06:36 +01:00

1.3 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 a valid 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 a valid 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