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

Henrique Moody d2198dfd01

Replace isValid() calls with assert()

There's more value on showing how `assert()` displays the validation
messages than simply showing if `isValid()` returns `true` or `false`.

However, that increases the chances of having outdated documentation, so
I created a doc linter that updates the Markdown files with the
correct message.

2026-01-13 23:37:06 -07:00

2.2 KiB

Raw Blame History

OneOf

OneOf(Validator $validator1, Validator $validator2)
OneOf(Validator $validator1, Validator $validator2, Validator ...$validators)

Will validate if exactly one inner validator passes.

v::oneOf(v::digit(), v::alpha())->assert('AB');
// Validation passes successfully

v::oneOf(v::digit(), v::alpha())->assert('12');
// Validation passes successfully

v::oneOf(v::digit(), v::alpha())->assert('AB12');
// → - "AB12" must pass one of the rules
// →   - "AB12" must contain only digits (0-9)
// →   - "AB12" must contain only letters (a-z)

v::oneOf(v::digit(), v::alpha())->assert('*');
// → - "*" must pass one of the rules
// →   - "*" must contain only digits (0-9)
// →   - "*" must contain only letters (a-z)

The chains above validate if the input is either a digit or an alphabetic character, one or the other, but not neither nor both.

Templates

`OneOf::TEMPLATE_NONE`

Used when none of the validators have passed.

Mode	Template
`default`	{{subject}} must pass one of the rules
`inverted`	{{subject}} must pass one of the rules

`OneOf::TEMPLATE_MORE_THAN_ONE`

Used when more than one validator has passed.

Mode	Template
`default`	{{subject}} must pass only one of the rules
`inverted`	{{subject}} must pass only one of the rules

Template placeholders

Placeholder	Description
`subject`	The validated input or the custom validator name (if specified).

Categorization

Composite
Nesting

Changelog

Version	Description
3.0.0	Require at least two validators to be passed
0.3.9	Created

2.2 KiB Raw Blame History