summaryrefslogtreecommitdiffstats
path: root/vendor/webmozart/assert
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--vendor/webmozart/assert/LICENSE20
-rw-r--r--vendor/webmozart/assert/composer.json43
-rw-r--r--vendor/webmozart/assert/src/Assert.php2080
-rw-r--r--vendor/webmozart/assert/src/InvalidArgumentException.php16
-rw-r--r--vendor/webmozart/assert/src/Mixin.php5089
5 files changed, 7248 insertions, 0 deletions
diff --git a/vendor/webmozart/assert/LICENSE b/vendor/webmozart/assert/LICENSE
new file mode 100644
index 0000000..9e2e307
--- /dev/null
+++ b/vendor/webmozart/assert/LICENSE
@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Bernhard Schussek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/vendor/webmozart/assert/composer.json b/vendor/webmozart/assert/composer.json
new file mode 100644
index 0000000..b340452
--- /dev/null
+++ b/vendor/webmozart/assert/composer.json
@@ -0,0 +1,43 @@
+{
+ "name": "webmozart/assert",
+ "description": "Assertions to validate method input/output with nice error messages.",
+ "license": "MIT",
+ "keywords": [
+ "assert",
+ "check",
+ "validate"
+ ],
+ "authors": [
+ {
+ "name": "Bernhard Schussek",
+ "email": "bschussek@gmail.com"
+ }
+ ],
+ "require": {
+ "php": "^7.2 || ^8.0",
+ "ext-ctype": "*"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^8.5.13"
+ },
+ "conflict": {
+ "phpstan/phpstan": "<0.12.20",
+ "vimeo/psalm": "<4.6.1 || 4.6.2"
+ },
+ "autoload": {
+ "psr-4": {
+ "Webmozart\\Assert\\": "src/"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "Webmozart\\Assert\\Tests\\": "tests/",
+ "Webmozart\\Assert\\Bin\\": "bin/src"
+ }
+ },
+ "extra": {
+ "branch-alias": {
+ "dev-master": "1.10-dev"
+ }
+ }
+}
diff --git a/vendor/webmozart/assert/src/Assert.php b/vendor/webmozart/assert/src/Assert.php
new file mode 100644
index 0000000..db1f3a5
--- /dev/null
+++ b/vendor/webmozart/assert/src/Assert.php
@@ -0,0 +1,2080 @@
+<?php
+
+/*
+ * This file is part of the webmozart/assert package.
+ *
+ * (c) Bernhard Schussek <bschussek@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Webmozart\Assert;
+
+use ArrayAccess;
+use BadMethodCallException;
+use Closure;
+use Countable;
+use DateTime;
+use DateTimeImmutable;
+use Exception;
+use ResourceBundle;
+use SimpleXMLElement;
+use Throwable;
+use Traversable;
+
+/**
+ * Efficient assertions to validate the input/output of your methods.
+ *
+ * @since 1.0
+ *
+ * @author Bernhard Schussek <bschussek@gmail.com>
+ */
+class Assert
+{
+ use Mixin;
+
+ /**
+ * @psalm-pure
+ * @psalm-assert string $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function string($value, $message = '')
+ {
+ if (!\is_string($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a string. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert non-empty-string $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function stringNotEmpty($value, $message = '')
+ {
+ static::string($value, $message);
+ static::notEq($value, '', $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert int $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function integer($value, $message = '')
+ {
+ if (!\is_int($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an integer. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert numeric $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function integerish($value, $message = '')
+ {
+ if (!\is_numeric($value) || $value != (int) $value) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an integerish value. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert positive-int $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function positiveInteger($value, $message = '')
+ {
+ if (!(\is_int($value) && $value > 0)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a positive integer. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert float $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function float($value, $message = '')
+ {
+ if (!\is_float($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a float. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert numeric $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function numeric($value, $message = '')
+ {
+ if (!\is_numeric($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a numeric. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert positive-int|0 $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function natural($value, $message = '')
+ {
+ if (!\is_int($value) || $value < 0) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a non-negative integer. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert bool $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function boolean($value, $message = '')
+ {
+ if (!\is_bool($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a boolean. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert scalar $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function scalar($value, $message = '')
+ {
+ if (!\is_scalar($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a scalar. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert object $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function object($value, $message = '')
+ {
+ if (!\is_object($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an object. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert resource $value
+ *
+ * @param mixed $value
+ * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function resource($value, $type = null, $message = '')
+ {
+ if (!\is_resource($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a resource. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+
+ if ($type && $type !== \get_resource_type($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a resource of type %2$s. Got: %s',
+ static::typeToString($value),
+ $type
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert callable $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isCallable($value, $message = '')
+ {
+ if (!\is_callable($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a callable. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert array $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isArray($value, $message = '')
+ {
+ if (!\is_array($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an array. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable $value
+ *
+ * @deprecated use "isIterable" or "isInstanceOf" instead
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isTraversable($value, $message = '')
+ {
+ @\trigger_error(
+ \sprintf(
+ 'The "%s" assertion is deprecated. You should stop using it, as it will soon be removed in 2.0 version. Use "isIterable" or "isInstanceOf" instead.',
+ __METHOD__
+ ),
+ \E_USER_DEPRECATED
+ );
+
+ if (!\is_array($value) && !($value instanceof Traversable)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a traversable. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert array|ArrayAccess $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isArrayAccessible($value, $message = '')
+ {
+ if (!\is_array($value) && !($value instanceof ArrayAccess)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an array accessible. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert countable $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isCountable($value, $message = '')
+ {
+ if (
+ !\is_array($value)
+ && !($value instanceof Countable)
+ && !($value instanceof ResourceBundle)
+ && !($value instanceof SimpleXMLElement)
+ ) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a countable. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isIterable($value, $message = '')
+ {
+ if (!\is_array($value) && !($value instanceof Traversable)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an iterable. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert ExpectedType $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isInstanceOf($value, $class, $message = '')
+ {
+ if (!($value instanceof $class)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an instance of %2$s. Got: %s',
+ static::typeToString($value),
+ $class
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert !ExpectedType $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notInstanceOf($value, $class, $message = '')
+ {
+ if ($value instanceof $class) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an instance other than %2$s. Got: %s',
+ static::typeToString($value),
+ $class
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param array<class-string> $classes
+ *
+ * @param mixed $value
+ * @param array<object|string> $classes
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isInstanceOfAny($value, array $classes, $message = '')
+ {
+ foreach ($classes as $class) {
+ if ($value instanceof $class) {
+ return;
+ }
+ }
+
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an instance of any of %2$s. Got: %s',
+ static::typeToString($value),
+ \implode(', ', \array_map(array(static::class, 'valueToString'), $classes))
+ ));
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert ExpectedType|class-string<ExpectedType> $value
+ *
+ * @param object|string $value
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isAOf($value, $class, $message = '')
+ {
+ static::string($class, 'Expected class as a string. Got: %s');
+
+ if (!\is_a($value, $class, \is_string($value))) {
+ static::reportInvalidArgument(sprintf(
+ $message ?: 'Expected an instance of this class or to this class among its parents "%2$s". Got: %s',
+ static::valueToString($value),
+ $class
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template UnexpectedType of object
+ * @psalm-param class-string<UnexpectedType> $class
+ * @psalm-assert !UnexpectedType $value
+ * @psalm-assert !class-string<UnexpectedType> $value
+ *
+ * @param object|string $value
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isNotA($value, $class, $message = '')
+ {
+ static::string($class, 'Expected class as a string. Got: %s');
+
+ if (\is_a($value, $class, \is_string($value))) {
+ static::reportInvalidArgument(sprintf(
+ $message ?: 'Expected an instance of this class or to this class among its parents other than "%2$s". Got: %s',
+ static::valueToString($value),
+ $class
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param array<class-string> $classes
+ *
+ * @param object|string $value
+ * @param string[] $classes
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isAnyOf($value, array $classes, $message = '')
+ {
+ foreach ($classes as $class) {
+ static::string($class, 'Expected class as a string. Got: %s');
+
+ if (\is_a($value, $class, \is_string($value))) {
+ return;
+ }
+ }
+
+ static::reportInvalidArgument(sprintf(
+ $message ?: 'Expected an instance of any of this classes or any of those classes among their parents "%2$s". Got: %s',
+ static::valueToString($value),
+ \implode(', ', $classes)
+ ));
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert empty $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isEmpty($value, $message = '')
+ {
+ if (!empty($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an empty value. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert !empty $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notEmpty($value, $message = '')
+ {
+ if (empty($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a non-empty value. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function null($value, $message = '')
+ {
+ if (null !== $value) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected null. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert !null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notNull($value, $message = '')
+ {
+ if (null === $value) {
+ static::reportInvalidArgument(
+ $message ?: 'Expected a value other than null.'
+ );
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert true $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function true($value, $message = '')
+ {
+ if (true !== $value) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to be true. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert false $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function false($value, $message = '')
+ {
+ if (false !== $value) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to be false. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert !false $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notFalse($value, $message = '')
+ {
+ if (false === $value) {
+ static::reportInvalidArgument(
+ $message ?: 'Expected a value other than false.'
+ );
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function ip($value, $message = '')
+ {
+ if (false === \filter_var($value, \FILTER_VALIDATE_IP)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to be an IP. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function ipv4($value, $message = '')
+ {
+ if (false === \filter_var($value, \FILTER_VALIDATE_IP, \FILTER_FLAG_IPV4)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to be an IPv4. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function ipv6($value, $message = '')
+ {
+ if (false === \filter_var($value, \FILTER_VALIDATE_IP, \FILTER_FLAG_IPV6)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to be an IPv6. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function email($value, $message = '')
+ {
+ if (false === \filter_var($value, FILTER_VALIDATE_EMAIL)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to be a valid e-mail address. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * Does non strict comparisons on the items, so ['3', 3] will not pass the assertion.
+ *
+ * @param array $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function uniqueValues(array $values, $message = '')
+ {
+ $allValues = \count($values);
+ $uniqueValues = \count(\array_unique($values));
+
+ if ($allValues !== $uniqueValues) {
+ $difference = $allValues - $uniqueValues;
+
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an array of unique values, but %s of them %s duplicated',
+ $difference,
+ (1 === $difference ? 'is' : 'are')
+ ));
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function eq($value, $expect, $message = '')
+ {
+ if ($expect != $value) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value equal to %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($expect)
+ ));
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notEq($value, $expect, $message = '')
+ {
+ if ($expect == $value) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a different value than %s.',
+ static::valueToString($expect)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function same($value, $expect, $message = '')
+ {
+ if ($expect !== $value) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value identical to %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($expect)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notSame($value, $expect, $message = '')
+ {
+ if ($expect === $value) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value not identical to %s.',
+ static::valueToString($expect)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function greaterThan($value, $limit, $message = '')
+ {
+ if ($value <= $limit) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value greater than %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($limit)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function greaterThanEq($value, $limit, $message = '')
+ {
+ if ($value < $limit) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value greater than or equal to %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($limit)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function lessThan($value, $limit, $message = '')
+ {
+ if ($value >= $limit) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value less than %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($limit)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function lessThanEq($value, $limit, $message = '')
+ {
+ if ($value > $limit) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value less than or equal to %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($limit)
+ ));
+ }
+ }
+
+ /**
+ * Inclusive range, so Assert::(3, 3, 5) passes.
+ *
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $min
+ * @param mixed $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function range($value, $min, $max, $message = '')
+ {
+ if ($value < $min || $value > $max) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value between %2$s and %3$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($min),
+ static::valueToString($max)
+ ));
+ }
+ }
+
+ /**
+ * A more human-readable alias of Assert::inArray().
+ *
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param array $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function oneOf($value, array $values, $message = '')
+ {
+ static::inArray($value, $values, $message);
+ }
+
+ /**
+ * Does strict comparison, so Assert::inArray(3, ['3']) does not pass the assertion.
+ *
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param array $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function inArray($value, array $values, $message = '')
+ {
+ if (!\in_array($value, $values, true)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected one of: %2$s. Got: %s',
+ static::valueToString($value),
+ \implode(', ', \array_map(array(static::class, 'valueToString'), $values))
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $subString
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function contains($value, $subString, $message = '')
+ {
+ if (false === \strpos($value, $subString)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($subString)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $subString
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notContains($value, $subString, $message = '')
+ {
+ if (false !== \strpos($value, $subString)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: '%2$s was not expected to be contained in a value. Got: %s',
+ static::valueToString($value),
+ static::valueToString($subString)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notWhitespaceOnly($value, $message = '')
+ {
+ if (\preg_match('/^\s*$/', $value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a non-whitespace string. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $prefix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function startsWith($value, $prefix, $message = '')
+ {
+ if (0 !== \strpos($value, $prefix)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to start with %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($prefix)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $prefix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notStartsWith($value, $prefix, $message = '')
+ {
+ if (0 === \strpos($value, $prefix)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value not to start with %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($prefix)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function startsWithLetter($value, $message = '')
+ {
+ static::string($value);
+
+ $valid = isset($value[0]);
+
+ if ($valid) {
+ $locale = \setlocale(LC_CTYPE, 0);
+ \setlocale(LC_CTYPE, 'C');
+ $valid = \ctype_alpha($value[0]);
+ \setlocale(LC_CTYPE, $locale);
+ }
+
+ if (!$valid) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to start with a letter. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $suffix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function endsWith($value, $suffix, $message = '')
+ {
+ if ($suffix !== \substr($value, -\strlen($suffix))) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to end with %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($suffix)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $suffix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notEndsWith($value, $suffix, $message = '')
+ {
+ if ($suffix === \substr($value, -\strlen($suffix))) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value not to end with %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($suffix)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $pattern
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function regex($value, $pattern, $message = '')
+ {
+ if (!\preg_match($pattern, $value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'The value %s does not match the expected pattern.',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $pattern
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function notRegex($value, $pattern, $message = '')
+ {
+ if (\preg_match($pattern, $value, $matches, PREG_OFFSET_CAPTURE)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'The value %s matches the pattern %s (at offset %d).',
+ static::valueToString($value),
+ static::valueToString($pattern),
+ $matches[0][1]
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function unicodeLetters($value, $message = '')
+ {
+ static::string($value);
+
+ if (!\preg_match('/^\p{L}+$/u', $value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain only Unicode letters. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function alpha($value, $message = '')
+ {
+ static::string($value);
+
+ $locale = \setlocale(LC_CTYPE, 0);
+ \setlocale(LC_CTYPE, 'C');
+ $valid = !\ctype_alpha($value);
+ \setlocale(LC_CTYPE, $locale);
+
+ if ($valid) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain only letters. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function digits($value, $message = '')
+ {
+ $locale = \setlocale(LC_CTYPE, 0);
+ \setlocale(LC_CTYPE, 'C');
+ $valid = !\ctype_digit($value);
+ \setlocale(LC_CTYPE, $locale);
+
+ if ($valid) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain digits only. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function alnum($value, $message = '')
+ {
+ $locale = \setlocale(LC_CTYPE, 0);
+ \setlocale(LC_CTYPE, 'C');
+ $valid = !\ctype_alnum($value);
+ \setlocale(LC_CTYPE, $locale);
+
+ if ($valid) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain letters and digits only. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert lowercase-string $value
+ *
+ * @param string $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function lower($value, $message = '')
+ {
+ $locale = \setlocale(LC_CTYPE, 0);
+ \setlocale(LC_CTYPE, 'C');
+ $valid = !\ctype_lower($value);
+ \setlocale(LC_CTYPE, $locale);
+
+ if ($valid) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain lowercase characters only. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert !lowercase-string $value
+ *
+ * @param string $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function upper($value, $message = '')
+ {
+ $locale = \setlocale(LC_CTYPE, 0);
+ \setlocale(LC_CTYPE, 'C');
+ $valid = !\ctype_upper($value);
+ \setlocale(LC_CTYPE, $locale);
+
+ if ($valid) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain uppercase characters only. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param int $length
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function length($value, $length, $message = '')
+ {
+ if ($length !== static::strlen($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain %2$s characters. Got: %s',
+ static::valueToString($value),
+ $length
+ ));
+ }
+ }
+
+ /**
+ * Inclusive min.
+ *
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param int|float $min
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function minLength($value, $min, $message = '')
+ {
+ if (static::strlen($value) < $min) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain at least %2$s characters. Got: %s',
+ static::valueToString($value),
+ $min
+ ));
+ }
+ }
+
+ /**
+ * Inclusive max.
+ *
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function maxLength($value, $max, $message = '')
+ {
+ if (static::strlen($value) > $max) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain at most %2$s characters. Got: %s',
+ static::valueToString($value),
+ $max
+ ));
+ }
+ }
+
+ /**
+ * Inclusive , so Assert::lengthBetween('asd', 3, 5); passes the assertion.
+ *
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param int|float $min
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function lengthBetween($value, $min, $max, $message = '')
+ {
+ $length = static::strlen($value);
+
+ if ($length < $min || $length > $max) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a value to contain between %2$s and %3$s characters. Got: %s',
+ static::valueToString($value),
+ $min,
+ $max
+ ));
+ }
+ }
+
+ /**
+ * Will also pass if $value is a directory, use Assert::file() instead if you need to be sure it is a file.
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function fileExists($value, $message = '')
+ {
+ static::string($value);
+
+ if (!\file_exists($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'The file %s does not exist.',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function file($value, $message = '')
+ {
+ static::fileExists($value, $message);
+
+ if (!\is_file($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'The path %s is not a file.',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function directory($value, $message = '')
+ {
+ static::fileExists($value, $message);
+
+ if (!\is_dir($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'The path %s is no directory.',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @param string $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function readable($value, $message = '')
+ {
+ if (!\is_readable($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'The path %s is not readable.',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @param string $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function writable($value, $message = '')
+ {
+ if (!\is_writable($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'The path %s is not writable.',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-assert class-string $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function classExists($value, $message = '')
+ {
+ if (!\class_exists($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an existing class name. Got: %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert class-string<ExpectedType>|ExpectedType $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function subclassOf($value, $class, $message = '')
+ {
+ if (!\is_subclass_of($value, $class)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected a sub-class of %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($class)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-assert class-string $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function interfaceExists($value, $message = '')
+ {
+ if (!\interface_exists($value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an existing interface name. got %s',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $interface
+ * @psalm-assert class-string<ExpectedType> $value
+ *
+ * @param mixed $value
+ * @param mixed $interface
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function implementsInterface($value, $interface, $message = '')
+ {
+ if (!\in_array($interface, \class_implements($value))) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an implementation of %2$s. Got: %s',
+ static::valueToString($value),
+ static::valueToString($interface)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param class-string|object $classOrObject
+ *
+ * @param string|object $classOrObject
+ * @param mixed $property
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function propertyExists($classOrObject, $property, $message = '')
+ {
+ if (!\property_exists($classOrObject, $property)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected the property %s to exist.',
+ static::valueToString($property)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param class-string|object $classOrObject
+ *
+ * @param string|object $classOrObject
+ * @param mixed $property
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function propertyNotExists($classOrObject, $property, $message = '')
+ {
+ if (\property_exists($classOrObject, $property)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected the property %s to not exist.',
+ static::valueToString($property)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param class-string|object $classOrObject
+ *
+ * @param string|object $classOrObject
+ * @param mixed $method
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function methodExists($classOrObject, $method, $message = '')
+ {
+ if (!(\is_string($classOrObject) || \is_object($classOrObject)) || !\method_exists($classOrObject, $method)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected the method %s to exist.',
+ static::valueToString($method)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param class-string|object $classOrObject
+ *
+ * @param string|object $classOrObject
+ * @param mixed $method
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function methodNotExists($classOrObject, $method, $message = '')
+ {
+ if ((\is_string($classOrObject) || \is_object($classOrObject)) && \method_exists($classOrObject, $method)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected the method %s to not exist.',
+ static::valueToString($method)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param array $array
+ * @param string|int $key
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function keyExists($array, $key, $message = '')
+ {
+ if (!(isset($array[$key]) || \array_key_exists($key, $array))) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected the key %s to exist.',
+ static::valueToString($key)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param array $array
+ * @param string|int $key
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function keyNotExists($array, $key, $message = '')
+ {
+ if (isset($array[$key]) || \array_key_exists($key, $array)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected the key %s to not exist.',
+ static::valueToString($key)
+ ));
+ }
+ }
+
+ /**
+ * Checks if a value is a valid array key (int or string).
+ *
+ * @psalm-pure
+ * @psalm-assert array-key $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function validArrayKey($value, $message = '')
+ {
+ if (!(\is_int($value) || \is_string($value))) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected string or integer. Got: %s',
+ static::typeToString($value)
+ ));
+ }
+ }
+
+ /**
+ * Does not check if $array is countable, this can generate a warning on php versions after 7.2.
+ *
+ * @param Countable|array $array
+ * @param int $number
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function count($array, $number, $message = '')
+ {
+ static::eq(
+ \count($array),
+ $number,
+ \sprintf(
+ $message ?: 'Expected an array to contain %d elements. Got: %d.',
+ $number,
+ \count($array)
+ )
+ );
+ }
+
+ /**
+ * Does not check if $array is countable, this can generate a warning on php versions after 7.2.
+ *
+ * @param Countable|array $array
+ * @param int|float $min
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function minCount($array, $min, $message = '')
+ {
+ if (\count($array) < $min) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an array to contain at least %2$d elements. Got: %d',
+ \count($array),
+ $min
+ ));
+ }
+ }
+
+ /**
+ * Does not check if $array is countable, this can generate a warning on php versions after 7.2.
+ *
+ * @param Countable|array $array
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function maxCount($array, $max, $message = '')
+ {
+ if (\count($array) > $max) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an array to contain at most %2$d elements. Got: %d',
+ \count($array),
+ $max
+ ));
+ }
+ }
+
+ /**
+ * Does not check if $array is countable, this can generate a warning on php versions after 7.2.
+ *
+ * @param Countable|array $array
+ * @param int|float $min
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function countBetween($array, $min, $max, $message = '')
+ {
+ $count = \count($array);
+
+ if ($count < $min || $count > $max) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Expected an array to contain between %2$d and %3$d elements. Got: %d',
+ $count,
+ $min,
+ $max
+ ));
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert list $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isList($array, $message = '')
+ {
+ if (!\is_array($array)) {
+ static::reportInvalidArgument(
+ $message ?: 'Expected list - non-associative array.'
+ );
+ }
+
+ if ($array === \array_values($array)) {
+ return;
+ }
+
+ $nextKey = -1;
+ foreach ($array as $k => $v) {
+ if ($k !== ++$nextKey) {
+ static::reportInvalidArgument(
+ $message ?: 'Expected list - non-associative array.'
+ );
+ }
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert non-empty-list $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isNonEmptyList($array, $message = '')
+ {
+ static::isList($array, $message);
+ static::notEmpty($array, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template T
+ * @psalm-param mixed|array<T> $array
+ * @psalm-assert array<string, T> $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isMap($array, $message = '')
+ {
+ if (
+ !\is_array($array) ||
+ \array_keys($array) !== \array_filter(\array_keys($array), '\is_string')
+ ) {
+ static::reportInvalidArgument(
+ $message ?: 'Expected map - associative array with string keys.'
+ );
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template T
+ * @psalm-param mixed|array<T> $array
+ * @psalm-assert array<string, T> $array
+ * @psalm-assert !empty $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function isNonEmptyMap($array, $message = '')
+ {
+ static::isMap($array, $message);
+ static::notEmpty($array, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function uuid($value, $message = '')
+ {
+ $value = \str_replace(array('urn:', 'uuid:', '{', '}'), '', $value);
+
+ // The nil UUID is special form of UUID that is specified to have all
+ // 128 bits set to zero.
+ if ('00000000-0000-0000-0000-000000000000' === $value) {
+ return;
+ }
+
+ if (!\preg_match('/^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$/', $value)) {
+ static::reportInvalidArgument(\sprintf(
+ $message ?: 'Value %s is not a valid UUID.',
+ static::valueToString($value)
+ ));
+ }
+ }
+
+ /**
+ * @psalm-param class-string<Throwable> $class
+ *
+ * @param Closure $expression
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ */
+ public static function throws(Closure $expression, $class = 'Exception', $message = '')
+ {
+ static::string($class);
+
+ $actual = 'none';
+
+ try {
+ $expression();
+ } catch (Exception $e) {
+ $actual = \get_class($e);
+ if ($e instanceof $class) {
+ return;
+ }
+ } catch (Throwable $e) {
+ $actual = \get_class($e);
+ if ($e instanceof $class) {
+ return;
+ }
+ }
+
+ static::reportInvalidArgument($message ?: \sprintf(
+ 'Expected to throw "%s", got "%s"',
+ $class,
+ $actual
+ ));
+ }
+
+ /**
+ * @throws BadMethodCallException
+ */
+ public static function __callStatic($name, $arguments)
+ {
+ if ('nullOr' === \substr($name, 0, 6)) {
+ if (null !== $arguments[0]) {
+ $method = \lcfirst(\substr($name, 6));
+ \call_user_func_array(array(static::class, $method), $arguments);
+ }
+
+ return;
+ }
+
+ if ('all' === \substr($name, 0, 3)) {
+ static::isIterable($arguments[0]);
+
+ $method = \lcfirst(\substr($name, 3));
+ $args = $arguments;
+
+ foreach ($arguments[0] as $entry) {
+ $args[0] = $entry;
+
+ \call_user_func_array(array(static::class, $method), $args);
+ }
+
+ return;
+ }
+
+ throw new BadMethodCallException('No such method: '.$name);
+ }
+
+ /**
+ * @param mixed $value
+ *
+ * @return string
+ */
+ protected static function valueToString($value)
+ {
+ if (null === $value) {
+ return 'null';
+ }
+
+ if (true === $value) {
+ return 'true';
+ }
+
+ if (false === $value) {
+ return 'false';
+ }
+
+ if (\is_array($value)) {
+ return 'array';
+ }
+
+ if (\is_object($value)) {
+ if (\method_exists($value, '__toString')) {
+ return \get_class($value).': '.self::valueToString($value->__toString());
+ }
+
+ if ($value instanceof DateTime || $value instanceof DateTimeImmutable) {
+ return \get_class($value).': '.self::valueToString($value->format('c'));
+ }
+
+ return \get_class($value);
+ }
+
+ if (\is_resource($value)) {
+ return 'resource';
+ }
+
+ if (\is_string($value)) {
+ return '"'.$value.'"';
+ }
+
+ return (string) $value;
+ }
+
+ /**
+ * @param mixed $value
+ *
+ * @return string
+ */
+ protected static function typeToString($value)
+ {
+ return \is_object($value) ? \get_class($value) : \gettype($value);
+ }
+
+ protected static function strlen($value)
+ {
+ if (!\function_exists('mb_detect_encoding')) {
+ return \strlen($value);
+ }
+
+ if (false === $encoding = \mb_detect_encoding($value)) {
+ return \strlen($value);
+ }
+
+ return \mb_strlen($value, $encoding);
+ }
+
+ /**
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @psalm-pure this method is not supposed to perform side-effects
+ * @psalm-return never
+ */
+ protected static function reportInvalidArgument($message)
+ {
+ throw new InvalidArgumentException($message);
+ }
+
+ private function __construct()
+ {
+ }
+}
diff --git a/vendor/webmozart/assert/src/InvalidArgumentException.php b/vendor/webmozart/assert/src/InvalidArgumentException.php
new file mode 100644
index 0000000..9d95a58
--- /dev/null
+++ b/vendor/webmozart/assert/src/InvalidArgumentException.php
@@ -0,0 +1,16 @@
+<?php
+
+/*
+ * This file is part of the webmozart/assert package.
+ *
+ * (c) Bernhard Schussek <bschussek@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Webmozart\Assert;
+
+class InvalidArgumentException extends \InvalidArgumentException
+{
+}
diff --git a/vendor/webmozart/assert/src/Mixin.php b/vendor/webmozart/assert/src/Mixin.php
new file mode 100644
index 0000000..0f0a75e
--- /dev/null
+++ b/vendor/webmozart/assert/src/Mixin.php
@@ -0,0 +1,5089 @@
+<?php
+
+namespace Webmozart\Assert;
+
+use ArrayAccess;
+use Closure;
+use Countable;
+use Throwable;
+
+/**
+ * This trait provides nurllOr*, all* and allNullOr* variants of assertion base methods.
+ * Do not use this trait directly: it will change, and is not designed for reuse.
+ */
+trait Mixin
+{
+ /**
+ * @psalm-pure
+ * @psalm-assert string|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrString($value, $message = '')
+ {
+ null === $value || static::string($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<string> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allString($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::string($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<string|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrString($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::string($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert non-empty-string|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrStringNotEmpty($value, $message = '')
+ {
+ null === $value || static::stringNotEmpty($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<non-empty-string> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allStringNotEmpty($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::stringNotEmpty($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<non-empty-string|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrStringNotEmpty($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::stringNotEmpty($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert int|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrInteger($value, $message = '')
+ {
+ null === $value || static::integer($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<int> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allInteger($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::integer($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<int|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrInteger($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::integer($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert numeric|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIntegerish($value, $message = '')
+ {
+ null === $value || static::integerish($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<numeric> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIntegerish($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::integerish($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<numeric|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIntegerish($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::integerish($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert positive-int|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrPositiveInteger($value, $message = '')
+ {
+ null === $value || static::positiveInteger($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<positive-int> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allPositiveInteger($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::positiveInteger($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<positive-int|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrPositiveInteger($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::positiveInteger($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert float|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrFloat($value, $message = '')
+ {
+ null === $value || static::float($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<float> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allFloat($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::float($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<float|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrFloat($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::float($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert numeric|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNumeric($value, $message = '')
+ {
+ null === $value || static::numeric($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<numeric> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNumeric($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::numeric($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<numeric|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNumeric($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::numeric($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert positive-int|0|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNatural($value, $message = '')
+ {
+ null === $value || static::natural($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<positive-int|0> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNatural($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::natural($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<positive-int|0|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNatural($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::natural($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert bool|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrBoolean($value, $message = '')
+ {
+ null === $value || static::boolean($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<bool> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allBoolean($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::boolean($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<bool|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrBoolean($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::boolean($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert scalar|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrScalar($value, $message = '')
+ {
+ null === $value || static::scalar($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<scalar> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allScalar($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::scalar($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<scalar|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrScalar($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::scalar($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert object|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrObject($value, $message = '')
+ {
+ null === $value || static::object($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<object> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allObject($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::object($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<object|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrObject($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::object($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert resource|null $value
+ *
+ * @param mixed $value
+ * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrResource($value, $type = null, $message = '')
+ {
+ null === $value || static::resource($value, $type, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<resource> $value
+ *
+ * @param mixed $value
+ * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allResource($value, $type = null, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::resource($entry, $type, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<resource|null> $value
+ *
+ * @param mixed $value
+ * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrResource($value, $type = null, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::resource($entry, $type, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert callable|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsCallable($value, $message = '')
+ {
+ null === $value || static::isCallable($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<callable> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsCallable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isCallable($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<callable|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsCallable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isCallable($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert array|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsArray($value, $message = '')
+ {
+ null === $value || static::isArray($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<array> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsArray($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isArray($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<array|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsArray($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isArray($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable|null $value
+ *
+ * @deprecated use "isIterable" or "isInstanceOf" instead
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsTraversable($value, $message = '')
+ {
+ null === $value || static::isTraversable($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<iterable> $value
+ *
+ * @deprecated use "isIterable" or "isInstanceOf" instead
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsTraversable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isTraversable($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<iterable|null> $value
+ *
+ * @deprecated use "isIterable" or "isInstanceOf" instead
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsTraversable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isTraversable($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert array|ArrayAccess|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsArrayAccessible($value, $message = '')
+ {
+ null === $value || static::isArrayAccessible($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<array|ArrayAccess> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsArrayAccessible($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isArrayAccessible($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<array|ArrayAccess|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsArrayAccessible($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isArrayAccessible($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert countable|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsCountable($value, $message = '')
+ {
+ null === $value || static::isCountable($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<countable> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsCountable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isCountable($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<countable|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsCountable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isCountable($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsIterable($value, $message = '')
+ {
+ null === $value || static::isIterable($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<iterable> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsIterable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isIterable($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<iterable|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsIterable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isIterable($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert ExpectedType|null $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsInstanceOf($value, $class, $message = '')
+ {
+ null === $value || static::isInstanceOf($value, $class, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert iterable<ExpectedType> $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsInstanceOf($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isInstanceOf($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert iterable<ExpectedType|null> $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsInstanceOf($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isInstanceOf($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotInstanceOf($value, $class, $message = '')
+ {
+ null === $value || static::notInstanceOf($value, $class, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotInstanceOf($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notInstanceOf($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert iterable<!ExpectedType|null> $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotInstanceOf($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notInstanceOf($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param array<class-string> $classes
+ *
+ * @param mixed $value
+ * @param array<object|string> $classes
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsInstanceOfAny($value, $classes, $message = '')
+ {
+ null === $value || static::isInstanceOfAny($value, $classes, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param array<class-string> $classes
+ *
+ * @param mixed $value
+ * @param array<object|string> $classes
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsInstanceOfAny($value, $classes, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isInstanceOfAny($entry, $classes, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param array<class-string> $classes
+ *
+ * @param mixed $value
+ * @param array<object|string> $classes
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsInstanceOfAny($value, $classes, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isInstanceOfAny($entry, $classes, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert ExpectedType|class-string<ExpectedType>|null $value
+ *
+ * @param object|string|null $value
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsAOf($value, $class, $message = '')
+ {
+ null === $value || static::isAOf($value, $class, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert iterable<ExpectedType|class-string<ExpectedType>> $value
+ *
+ * @param iterable<object|string> $value
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsAOf($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isAOf($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert iterable<ExpectedType|class-string<ExpectedType>|null> $value
+ *
+ * @param iterable<object|string|null> $value
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsAOf($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isAOf($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template UnexpectedType of object
+ * @psalm-param class-string<UnexpectedType> $class
+ *
+ * @param object|string|null $value
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsNotA($value, $class, $message = '')
+ {
+ null === $value || static::isNotA($value, $class, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template UnexpectedType of object
+ * @psalm-param class-string<UnexpectedType> $class
+ *
+ * @param iterable<object|string> $value
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsNotA($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isNotA($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template UnexpectedType of object
+ * @psalm-param class-string<UnexpectedType> $class
+ * @psalm-assert iterable<!UnexpectedType|null> $value
+ * @psalm-assert iterable<!class-string<UnexpectedType>|null> $value
+ *
+ * @param iterable<object|string|null> $value
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsNotA($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isNotA($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param array<class-string> $classes
+ *
+ * @param object|string|null $value
+ * @param string[] $classes
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsAnyOf($value, $classes, $message = '')
+ {
+ null === $value || static::isAnyOf($value, $classes, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param array<class-string> $classes
+ *
+ * @param iterable<object|string> $value
+ * @param string[] $classes
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsAnyOf($value, $classes, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isAnyOf($entry, $classes, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param array<class-string> $classes
+ *
+ * @param iterable<object|string|null> $value
+ * @param string[] $classes
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsAnyOf($value, $classes, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isAnyOf($entry, $classes, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert empty $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsEmpty($value, $message = '')
+ {
+ null === $value || static::isEmpty($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<empty> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsEmpty($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::isEmpty($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<empty|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsEmpty($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::isEmpty($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotEmpty($value, $message = '')
+ {
+ null === $value || static::notEmpty($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotEmpty($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notEmpty($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<!empty|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotEmpty($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notEmpty($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNull($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::null($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotNull($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notNull($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert true|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrTrue($value, $message = '')
+ {
+ null === $value || static::true($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<true> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allTrue($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::true($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<true|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrTrue($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::true($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert false|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrFalse($value, $message = '')
+ {
+ null === $value || static::false($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<false> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allFalse($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::false($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<false|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrFalse($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::false($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotFalse($value, $message = '')
+ {
+ null === $value || static::notFalse($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotFalse($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notFalse($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<!false|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotFalse($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notFalse($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIp($value, $message = '')
+ {
+ null === $value || static::ip($value, $message);
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIp($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::ip($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIp($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::ip($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIpv4($value, $message = '')
+ {
+ null === $value || static::ipv4($value, $message);
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIpv4($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::ipv4($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIpv4($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::ipv4($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIpv6($value, $message = '')
+ {
+ null === $value || static::ipv6($value, $message);
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIpv6($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::ipv6($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIpv6($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::ipv6($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrEmail($value, $message = '')
+ {
+ null === $value || static::email($value, $message);
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allEmail($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::email($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrEmail($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::email($entry, $message);
+ }
+ }
+
+ /**
+ * @param array|null $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrUniqueValues($values, $message = '')
+ {
+ null === $values || static::uniqueValues($values, $message);
+ }
+
+ /**
+ * @param iterable<array> $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allUniqueValues($values, $message = '')
+ {
+ static::isIterable($values);
+
+ foreach ($values as $entry) {
+ static::uniqueValues($entry, $message);
+ }
+ }
+
+ /**
+ * @param iterable<array|null> $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrUniqueValues($values, $message = '')
+ {
+ static::isIterable($values);
+
+ foreach ($values as $entry) {
+ null === $entry || static::uniqueValues($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrEq($value, $expect, $message = '')
+ {
+ null === $value || static::eq($value, $expect, $message);
+ }
+
+ /**
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allEq($value, $expect, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::eq($entry, $expect, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrEq($value, $expect, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::eq($entry, $expect, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotEq($value, $expect, $message = '')
+ {
+ null === $value || static::notEq($value, $expect, $message);
+ }
+
+ /**
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotEq($value, $expect, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notEq($entry, $expect, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotEq($value, $expect, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notEq($entry, $expect, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrSame($value, $expect, $message = '')
+ {
+ null === $value || static::same($value, $expect, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allSame($value, $expect, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::same($entry, $expect, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrSame($value, $expect, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::same($entry, $expect, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotSame($value, $expect, $message = '')
+ {
+ null === $value || static::notSame($value, $expect, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotSame($value, $expect, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notSame($entry, $expect, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $expect
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotSame($value, $expect, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notSame($entry, $expect, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrGreaterThan($value, $limit, $message = '')
+ {
+ null === $value || static::greaterThan($value, $limit, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allGreaterThan($value, $limit, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::greaterThan($entry, $limit, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrGreaterThan($value, $limit, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::greaterThan($entry, $limit, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrGreaterThanEq($value, $limit, $message = '')
+ {
+ null === $value || static::greaterThanEq($value, $limit, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allGreaterThanEq($value, $limit, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::greaterThanEq($entry, $limit, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrGreaterThanEq($value, $limit, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::greaterThanEq($entry, $limit, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrLessThan($value, $limit, $message = '')
+ {
+ null === $value || static::lessThan($value, $limit, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allLessThan($value, $limit, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::lessThan($entry, $limit, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrLessThan($value, $limit, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::lessThan($entry, $limit, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrLessThanEq($value, $limit, $message = '')
+ {
+ null === $value || static::lessThanEq($value, $limit, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allLessThanEq($value, $limit, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::lessThanEq($entry, $limit, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $limit
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrLessThanEq($value, $limit, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::lessThanEq($entry, $limit, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $min
+ * @param mixed $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrRange($value, $min, $max, $message = '')
+ {
+ null === $value || static::range($value, $min, $max, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $min
+ * @param mixed $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allRange($value, $min, $max, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::range($entry, $min, $max, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param mixed $min
+ * @param mixed $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrRange($value, $min, $max, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::range($entry, $min, $max, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param array $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrOneOf($value, $values, $message = '')
+ {
+ null === $value || static::oneOf($value, $values, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param array $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allOneOf($value, $values, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::oneOf($entry, $values, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param array $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrOneOf($value, $values, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::oneOf($entry, $values, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param array $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrInArray($value, $values, $message = '')
+ {
+ null === $value || static::inArray($value, $values, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param array $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allInArray($value, $values, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::inArray($entry, $values, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param array $values
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrInArray($value, $values, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::inArray($entry, $values, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $subString
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrContains($value, $subString, $message = '')
+ {
+ null === $value || static::contains($value, $subString, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $subString
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allContains($value, $subString, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::contains($entry, $subString, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $subString
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrContains($value, $subString, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::contains($entry, $subString, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $subString
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotContains($value, $subString, $message = '')
+ {
+ null === $value || static::notContains($value, $subString, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $subString
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotContains($value, $subString, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notContains($entry, $subString, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $subString
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotContains($value, $subString, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notContains($entry, $subString, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotWhitespaceOnly($value, $message = '')
+ {
+ null === $value || static::notWhitespaceOnly($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotWhitespaceOnly($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notWhitespaceOnly($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotWhitespaceOnly($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notWhitespaceOnly($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $prefix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrStartsWith($value, $prefix, $message = '')
+ {
+ null === $value || static::startsWith($value, $prefix, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $prefix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allStartsWith($value, $prefix, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::startsWith($entry, $prefix, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $prefix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrStartsWith($value, $prefix, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::startsWith($entry, $prefix, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $prefix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotStartsWith($value, $prefix, $message = '')
+ {
+ null === $value || static::notStartsWith($value, $prefix, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $prefix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotStartsWith($value, $prefix, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notStartsWith($entry, $prefix, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $prefix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotStartsWith($value, $prefix, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notStartsWith($entry, $prefix, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrStartsWithLetter($value, $message = '')
+ {
+ null === $value || static::startsWithLetter($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allStartsWithLetter($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::startsWithLetter($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrStartsWithLetter($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::startsWithLetter($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $suffix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrEndsWith($value, $suffix, $message = '')
+ {
+ null === $value || static::endsWith($value, $suffix, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $suffix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allEndsWith($value, $suffix, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::endsWith($entry, $suffix, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $suffix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrEndsWith($value, $suffix, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::endsWith($entry, $suffix, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $suffix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotEndsWith($value, $suffix, $message = '')
+ {
+ null === $value || static::notEndsWith($value, $suffix, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $suffix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotEndsWith($value, $suffix, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notEndsWith($entry, $suffix, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $suffix
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotEndsWith($value, $suffix, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notEndsWith($entry, $suffix, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $pattern
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrRegex($value, $pattern, $message = '')
+ {
+ null === $value || static::regex($value, $pattern, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $pattern
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allRegex($value, $pattern, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::regex($entry, $pattern, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $pattern
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrRegex($value, $pattern, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::regex($entry, $pattern, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $pattern
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrNotRegex($value, $pattern, $message = '')
+ {
+ null === $value || static::notRegex($value, $pattern, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $pattern
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNotRegex($value, $pattern, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::notRegex($entry, $pattern, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $pattern
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrNotRegex($value, $pattern, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::notRegex($entry, $pattern, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrUnicodeLetters($value, $message = '')
+ {
+ null === $value || static::unicodeLetters($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allUnicodeLetters($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::unicodeLetters($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrUnicodeLetters($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::unicodeLetters($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrAlpha($value, $message = '')
+ {
+ null === $value || static::alpha($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allAlpha($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::alpha($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrAlpha($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::alpha($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrDigits($value, $message = '')
+ {
+ null === $value || static::digits($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allDigits($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::digits($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrDigits($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::digits($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrAlnum($value, $message = '')
+ {
+ null === $value || static::alnum($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allAlnum($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::alnum($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrAlnum($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::alnum($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert lowercase-string|null $value
+ *
+ * @param string|null $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrLower($value, $message = '')
+ {
+ null === $value || static::lower($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<lowercase-string> $value
+ *
+ * @param iterable<string> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allLower($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::lower($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<lowercase-string|null> $value
+ *
+ * @param iterable<string|null> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrLower($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::lower($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrUpper($value, $message = '')
+ {
+ null === $value || static::upper($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allUpper($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::upper($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<!lowercase-string|null> $value
+ *
+ * @param iterable<string|null> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrUpper($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::upper($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param int $length
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrLength($value, $length, $message = '')
+ {
+ null === $value || static::length($value, $length, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param int $length
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allLength($value, $length, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::length($entry, $length, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param int $length
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrLength($value, $length, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::length($entry, $length, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param int|float $min
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrMinLength($value, $min, $message = '')
+ {
+ null === $value || static::minLength($value, $min, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param int|float $min
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allMinLength($value, $min, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::minLength($entry, $min, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param int|float $min
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrMinLength($value, $min, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::minLength($entry, $min, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrMaxLength($value, $max, $message = '')
+ {
+ null === $value || static::maxLength($value, $max, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allMaxLength($value, $max, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::maxLength($entry, $max, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrMaxLength($value, $max, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::maxLength($entry, $max, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param int|float $min
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrLengthBetween($value, $min, $max, $message = '')
+ {
+ null === $value || static::lengthBetween($value, $min, $max, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param int|float $min
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allLengthBetween($value, $min, $max, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::lengthBetween($entry, $min, $max, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param int|float $min
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrLengthBetween($value, $min, $max, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::lengthBetween($entry, $min, $max, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrFileExists($value, $message = '')
+ {
+ null === $value || static::fileExists($value, $message);
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allFileExists($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::fileExists($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrFileExists($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::fileExists($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrFile($value, $message = '')
+ {
+ null === $value || static::file($value, $message);
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allFile($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::file($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrFile($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::file($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrDirectory($value, $message = '')
+ {
+ null === $value || static::directory($value, $message);
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allDirectory($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::directory($entry, $message);
+ }
+ }
+
+ /**
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrDirectory($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::directory($entry, $message);
+ }
+ }
+
+ /**
+ * @param string|null $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrReadable($value, $message = '')
+ {
+ null === $value || static::readable($value, $message);
+ }
+
+ /**
+ * @param iterable<string> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allReadable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::readable($entry, $message);
+ }
+ }
+
+ /**
+ * @param iterable<string|null> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrReadable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::readable($entry, $message);
+ }
+ }
+
+ /**
+ * @param string|null $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrWritable($value, $message = '')
+ {
+ null === $value || static::writable($value, $message);
+ }
+
+ /**
+ * @param iterable<string> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allWritable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::writable($entry, $message);
+ }
+ }
+
+ /**
+ * @param iterable<string|null> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrWritable($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::writable($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-assert class-string|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrClassExists($value, $message = '')
+ {
+ null === $value || static::classExists($value, $message);
+ }
+
+ /**
+ * @psalm-assert iterable<class-string> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allClassExists($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::classExists($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-assert iterable<class-string|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrClassExists($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::classExists($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert class-string<ExpectedType>|ExpectedType|null $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrSubclassOf($value, $class, $message = '')
+ {
+ null === $value || static::subclassOf($value, $class, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert iterable<class-string<ExpectedType>|ExpectedType> $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allSubclassOf($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::subclassOf($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $class
+ * @psalm-assert iterable<class-string<ExpectedType>|ExpectedType|null> $value
+ *
+ * @param mixed $value
+ * @param string|object $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrSubclassOf($value, $class, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::subclassOf($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-assert class-string|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrInterfaceExists($value, $message = '')
+ {
+ null === $value || static::interfaceExists($value, $message);
+ }
+
+ /**
+ * @psalm-assert iterable<class-string> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allInterfaceExists($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::interfaceExists($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-assert iterable<class-string|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrInterfaceExists($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::interfaceExists($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $interface
+ * @psalm-assert class-string<ExpectedType>|null $value
+ *
+ * @param mixed $value
+ * @param mixed $interface
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrImplementsInterface($value, $interface, $message = '')
+ {
+ null === $value || static::implementsInterface($value, $interface, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $interface
+ * @psalm-assert iterable<class-string<ExpectedType>> $value
+ *
+ * @param mixed $value
+ * @param mixed $interface
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allImplementsInterface($value, $interface, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::implementsInterface($entry, $interface, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template ExpectedType of object
+ * @psalm-param class-string<ExpectedType> $interface
+ * @psalm-assert iterable<class-string<ExpectedType>|null> $value
+ *
+ * @param mixed $value
+ * @param mixed $interface
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrImplementsInterface($value, $interface, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::implementsInterface($entry, $interface, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param class-string|object|null $classOrObject
+ *
+ * @param string|object|null $classOrObject
+ * @param mixed $property
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrPropertyExists($classOrObject, $property, $message = '')
+ {
+ null === $classOrObject || static::propertyExists($classOrObject, $property, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param iterable<class-string|object> $classOrObject
+ *
+ * @param iterable<string|object> $classOrObject
+ * @param mixed $property
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allPropertyExists($classOrObject, $property, $message = '')
+ {
+ static::isIterable($classOrObject);
+
+ foreach ($classOrObject as $entry) {
+ static::propertyExists($entry, $property, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param iterable<class-string|object|null> $classOrObject
+ *
+ * @param iterable<string|object|null> $classOrObject
+ * @param mixed $property
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrPropertyExists($classOrObject, $property, $message = '')
+ {
+ static::isIterable($classOrObject);
+
+ foreach ($classOrObject as $entry) {
+ null === $entry || static::propertyExists($entry, $property, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param class-string|object|null $classOrObject
+ *
+ * @param string|object|null $classOrObject
+ * @param mixed $property
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrPropertyNotExists($classOrObject, $property, $message = '')
+ {
+ null === $classOrObject || static::propertyNotExists($classOrObject, $property, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param iterable<class-string|object> $classOrObject
+ *
+ * @param iterable<string|object> $classOrObject
+ * @param mixed $property
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allPropertyNotExists($classOrObject, $property, $message = '')
+ {
+ static::isIterable($classOrObject);
+
+ foreach ($classOrObject as $entry) {
+ static::propertyNotExists($entry, $property, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param iterable<class-string|object|null> $classOrObject
+ *
+ * @param iterable<string|object|null> $classOrObject
+ * @param mixed $property
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrPropertyNotExists($classOrObject, $property, $message = '')
+ {
+ static::isIterable($classOrObject);
+
+ foreach ($classOrObject as $entry) {
+ null === $entry || static::propertyNotExists($entry, $property, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param class-string|object|null $classOrObject
+ *
+ * @param string|object|null $classOrObject
+ * @param mixed $method
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrMethodExists($classOrObject, $method, $message = '')
+ {
+ null === $classOrObject || static::methodExists($classOrObject, $method, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param iterable<class-string|object> $classOrObject
+ *
+ * @param iterable<string|object> $classOrObject
+ * @param mixed $method
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allMethodExists($classOrObject, $method, $message = '')
+ {
+ static::isIterable($classOrObject);
+
+ foreach ($classOrObject as $entry) {
+ static::methodExists($entry, $method, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param iterable<class-string|object|null> $classOrObject
+ *
+ * @param iterable<string|object|null> $classOrObject
+ * @param mixed $method
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrMethodExists($classOrObject, $method, $message = '')
+ {
+ static::isIterable($classOrObject);
+
+ foreach ($classOrObject as $entry) {
+ null === $entry || static::methodExists($entry, $method, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param class-string|object|null $classOrObject
+ *
+ * @param string|object|null $classOrObject
+ * @param mixed $method
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrMethodNotExists($classOrObject, $method, $message = '')
+ {
+ null === $classOrObject || static::methodNotExists($classOrObject, $method, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param iterable<class-string|object> $classOrObject
+ *
+ * @param iterable<string|object> $classOrObject
+ * @param mixed $method
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allMethodNotExists($classOrObject, $method, $message = '')
+ {
+ static::isIterable($classOrObject);
+
+ foreach ($classOrObject as $entry) {
+ static::methodNotExists($entry, $method, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-param iterable<class-string|object|null> $classOrObject
+ *
+ * @param iterable<string|object|null> $classOrObject
+ * @param mixed $method
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrMethodNotExists($classOrObject, $method, $message = '')
+ {
+ static::isIterable($classOrObject);
+
+ foreach ($classOrObject as $entry) {
+ null === $entry || static::methodNotExists($entry, $method, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param array|null $array
+ * @param string|int $key
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrKeyExists($array, $key, $message = '')
+ {
+ null === $array || static::keyExists($array, $key, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<array> $array
+ * @param string|int $key
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allKeyExists($array, $key, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::keyExists($entry, $key, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<array|null> $array
+ * @param string|int $key
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrKeyExists($array, $key, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::keyExists($entry, $key, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param array|null $array
+ * @param string|int $key
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrKeyNotExists($array, $key, $message = '')
+ {
+ null === $array || static::keyNotExists($array, $key, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<array> $array
+ * @param string|int $key
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allKeyNotExists($array, $key, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::keyNotExists($entry, $key, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<array|null> $array
+ * @param string|int $key
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrKeyNotExists($array, $key, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::keyNotExists($entry, $key, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert array-key|null $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrValidArrayKey($value, $message = '')
+ {
+ null === $value || static::validArrayKey($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<array-key> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allValidArrayKey($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::validArrayKey($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<array-key|null> $value
+ *
+ * @param mixed $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrValidArrayKey($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::validArrayKey($entry, $message);
+ }
+ }
+
+ /**
+ * @param Countable|array|null $array
+ * @param int $number
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrCount($array, $number, $message = '')
+ {
+ null === $array || static::count($array, $number, $message);
+ }
+
+ /**
+ * @param iterable<Countable|array> $array
+ * @param int $number
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allCount($array, $number, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::count($entry, $number, $message);
+ }
+ }
+
+ /**
+ * @param iterable<Countable|array|null> $array
+ * @param int $number
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrCount($array, $number, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::count($entry, $number, $message);
+ }
+ }
+
+ /**
+ * @param Countable|array|null $array
+ * @param int|float $min
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrMinCount($array, $min, $message = '')
+ {
+ null === $array || static::minCount($array, $min, $message);
+ }
+
+ /**
+ * @param iterable<Countable|array> $array
+ * @param int|float $min
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allMinCount($array, $min, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::minCount($entry, $min, $message);
+ }
+ }
+
+ /**
+ * @param iterable<Countable|array|null> $array
+ * @param int|float $min
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrMinCount($array, $min, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::minCount($entry, $min, $message);
+ }
+ }
+
+ /**
+ * @param Countable|array|null $array
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrMaxCount($array, $max, $message = '')
+ {
+ null === $array || static::maxCount($array, $max, $message);
+ }
+
+ /**
+ * @param iterable<Countable|array> $array
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allMaxCount($array, $max, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::maxCount($entry, $max, $message);
+ }
+ }
+
+ /**
+ * @param iterable<Countable|array|null> $array
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrMaxCount($array, $max, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::maxCount($entry, $max, $message);
+ }
+ }
+
+ /**
+ * @param Countable|array|null $array
+ * @param int|float $min
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrCountBetween($array, $min, $max, $message = '')
+ {
+ null === $array || static::countBetween($array, $min, $max, $message);
+ }
+
+ /**
+ * @param iterable<Countable|array> $array
+ * @param int|float $min
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allCountBetween($array, $min, $max, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::countBetween($entry, $min, $max, $message);
+ }
+ }
+
+ /**
+ * @param iterable<Countable|array|null> $array
+ * @param int|float $min
+ * @param int|float $max
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrCountBetween($array, $min, $max, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::countBetween($entry, $min, $max, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert list|null $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsList($array, $message = '')
+ {
+ null === $array || static::isList($array, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<list> $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsList($array, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::isList($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<list|null> $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsList($array, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::isList($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert non-empty-list|null $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsNonEmptyList($array, $message = '')
+ {
+ null === $array || static::isNonEmptyList($array, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<non-empty-list> $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsNonEmptyList($array, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::isNonEmptyList($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-assert iterable<non-empty-list|null> $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsNonEmptyList($array, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::isNonEmptyList($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template T
+ * @psalm-param mixed|array<T>|null $array
+ * @psalm-assert array<string, T>|null $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsMap($array, $message = '')
+ {
+ null === $array || static::isMap($array, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template T
+ * @psalm-param iterable<mixed|array<T>> $array
+ * @psalm-assert iterable<array<string, T>> $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsMap($array, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::isMap($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template T
+ * @psalm-param iterable<mixed|array<T>|null> $array
+ * @psalm-assert iterable<array<string, T>|null> $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsMap($array, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::isMap($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template T
+ * @psalm-param mixed|array<T>|null $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrIsNonEmptyMap($array, $message = '')
+ {
+ null === $array || static::isNonEmptyMap($array, $message);
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template T
+ * @psalm-param iterable<mixed|array<T>> $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allIsNonEmptyMap($array, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ static::isNonEmptyMap($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ * @psalm-template T
+ * @psalm-param iterable<mixed|array<T>|null> $array
+ * @psalm-assert iterable<array<string, T>|null> $array
+ * @psalm-assert iterable<!empty|null> $array
+ *
+ * @param mixed $array
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrIsNonEmptyMap($array, $message = '')
+ {
+ static::isIterable($array);
+
+ foreach ($array as $entry) {
+ null === $entry || static::isNonEmptyMap($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param string|null $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrUuid($value, $message = '')
+ {
+ null === $value || static::uuid($value, $message);
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allUuid($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ static::uuid($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-pure
+ *
+ * @param iterable<string|null> $value
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrUuid($value, $message = '')
+ {
+ static::isIterable($value);
+
+ foreach ($value as $entry) {
+ null === $entry || static::uuid($entry, $message);
+ }
+ }
+
+ /**
+ * @psalm-param class-string<Throwable> $class
+ *
+ * @param Closure|null $expression
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function nullOrThrows($expression, $class = 'Exception', $message = '')
+ {
+ null === $expression || static::throws($expression, $class, $message);
+ }
+
+ /**
+ * @psalm-param class-string<Throwable> $class
+ *
+ * @param iterable<Closure> $expression
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allThrows($expression, $class = 'Exception', $message = '')
+ {
+ static::isIterable($expression);
+
+ foreach ($expression as $entry) {
+ static::throws($entry, $class, $message);
+ }
+ }
+
+ /**
+ * @psalm-param class-string<Throwable> $class
+ *
+ * @param iterable<Closure|null> $expression
+ * @param string $class
+ * @param string $message
+ *
+ * @throws InvalidArgumentException
+ *
+ * @return void
+ */
+ public static function allNullOrThrows($expression, $class = 'Exception', $message = '')
+ {
+ static::isIterable($expression);
+
+ foreach ($expression as $entry) {
+ null === $entry || static::throws($entry, $class, $message);
+ }
+ }
+}