respect-validation/docs/validators/ContainsAny.md
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

1.7 KiB

ContainsAny

  • ContainsAny(non-empty-array<mixed> $needles)
  • ContainsAny(non-empty-array<mixed> $needles, bool $identical)

Validates if the input contains at least one of defined values

For strings (comparing is case insensitive):

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

For arrays (comparing is case sensitive to respect "contains" behavior):

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

A second parameter may be passed for identical comparison instead of equal comparison for arrays.

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
2.0.0 Created

See also: