respect-validation/docs/validators/ContainsAny.md
Alexandre Gomes Gaigalas bd48bdcda4 Lint Changelog format in validator docs
Introduces a Markdown linter for checking the Changelog format.

"See Also" was transformed into a section to make it easier to
handle it with the `Content` class. The "Related" linter was
simplified to reflect that change too.

An additional "alignment" parameter was added to markdown table
generators, allowing the padding and headers to be explicitly
marked with a specific left (-1), middle (0) or right(1)
alignment.

Existing files were fixed using the `fix` option after the
changes.
2026-01-26 19:11:00 +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