mirror of https://github.com/Respect/Validation.git synced 2026-03-14 22:35:45 +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

Contains

Contains(mixed $containsValue)

Validates if the input contains some value.

For strings:

v::contains('ipsum')->assert('lorem ipsum');
// Validation passes successfully

For arrays:

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

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

Templates

`Contains::TEMPLATE_STANDARD`

Mode	Template
`default`	{{subject}} must contain {{containsValue}}
`inverted`	{{subject}} must not contain {{containsValue}}

Template placeholders

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

Categorization

Arrays
Strings

Changelog

Version	Description
3.0.0	Case-insensitive comparison removed
0.3.9	Created

1.6 KiB Raw Blame History