mirror of https://github.com/Respect/Validation.git synced 2026-03-17 23:59:51 +01:00

Alexandre Gomes Gaigalas d9cdc118b2 Introduce REUSE compliance

This commit introduces REUSE compliance by annotating all files
with SPDX information and placing the reused licences in the
LICENSES folder.

We additionally removed the docheader tool which is made obsolete
by this change.

The main LICENSE and copyright text of the project is now not under
my personal name anymore, and it belongs to "The Respect Project
Contributors" instead.

This change restores author names to several files, giving the
appropriate attribution for contributions.

2026-01-21 06:28:11 +00:00

2.3 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.3 KiB Raw Blame History