mirror of https://github.com/Respect/Validation.git synced 2026-03-15 06:45: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.5 KiB

Raw Blame History

In

In(mixed $haystack)

Validates if the input is contained in a specific haystack.

For strings:

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

For arrays:

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

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

Templates

`In::TEMPLATE_STANDARD`

Mode	Template
`default`	{{subject}} must be in {{haystack}}
`inverted`	{{subject}} must not be in {{haystack}}

Template placeholders

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

Categorization

Arrays
Comparisons
Strings

Changelog

Version	Description
3.0.0	Case-insensitive comparison removed
0.3.9	Created

1.5 KiB Raw Blame History

In