mirror of https://github.com/Respect/Validation.git synced 2026-03-15 14:55:44 +01:00

Alexandre Gomes Gaigalas ec16b3d2df Refactor case sensitiveness support

This is a mid-size refactor that affects several validators.

Most prominently, the ones that had an `$identical` parameter
to deal with case sensitiveness.

This parameter was confusing, effectively making validators such
as `Contains` behave very differently for arrays versus strings.

In arrays, `$identical` meant "the same type", while it in strings
it meant "case sensitive".

That parameter was removed, and the default behavior is now to
always compare **case sensitive** and strict typing.

A document explaining how to combine other validators in order
to achieve case _insensitive_ comparisons was added.

Additionally, the `Call` validator was refactored back to be
suitable to take on the task of being a fast, quick composable
validator.

With the introduction of `Circuit`, we can shift the responsibility
of dealing with possible mismatches to the user. This kind of type
handling is demonstrated in how I refactored `Tld` to account for
the type mismatch without setting error handlers.

2026-01-30 17:11:13 +00:00

1.6 KiB

Raw Blame History

ContainsAny

ContainsAny(non-empty-array<mixed> $needles)

Validates if the input contains at least one of defined values

For strings:

v::containsAny(['lorem', 'dolor'])->assert('lorem ipsum');
// Validation passes successfully

For arrays:

v::containsAny(['lorem', 'dolor'])->assert(['ipsum', 'lorem']);
// Validation passes successfully

Message template for this validator includes {{needles}}.

Templates

`ContainsAny::TEMPLATE_STANDARD`

Mode	Template
`default`	{{subject}} must contain at least one value from {{needles}}
`inverted`	{{subject}} must not contain any value from {{needles}}

Template placeholders

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

Categorization

Arrays
Strings

Changelog

Version	Description
3.0.0	Case-insensitive comparison removed
2.0.0	Created

1.6 KiB Raw Blame History