mirror of
https://github.com/Respect/Validation.git
synced 2026-03-17 15:50:03 +01:00
Besides the interface's name, everything already calls this type "Rule", not "Validatable." This commit puts a stone on it and renames the interface for better naming.
179 lines
4.1 KiB
PHP
179 lines
4.1 KiB
PHP
<?php
|
|
|
|
/*
|
|
* Copyright (c) Alexandre Gomes Gaigalas <alganet@gmail.com>
|
|
* SPDX-License-Identifier: MIT
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Respect\Validation;
|
|
|
|
use Respect\Validation\Exceptions\ValidationException;
|
|
use Respect\Validation\Helpers\CanBindEvaluateRule;
|
|
use Respect\Validation\Message\Formatter;
|
|
use Respect\Validation\Message\Translator;
|
|
use Respect\Validation\Mixins\StaticValidator;
|
|
use Respect\Validation\Rules\AllOf;
|
|
use Throwable;
|
|
|
|
use function count;
|
|
use function current;
|
|
use function is_array;
|
|
use function is_string;
|
|
|
|
/**
|
|
* @mixin StaticValidator
|
|
*/
|
|
final class Validator implements Rule
|
|
{
|
|
use CanBindEvaluateRule;
|
|
|
|
/** @var array<Rule> */
|
|
private array $rules = [];
|
|
|
|
/** @var array<string, mixed> */
|
|
private array $templates = [];
|
|
|
|
private ?string $name = null;
|
|
|
|
private ?string $template = null;
|
|
|
|
public function __construct(
|
|
private readonly Factory $factory,
|
|
private readonly Formatter $formatter,
|
|
private readonly Translator $translator,
|
|
) {
|
|
}
|
|
|
|
public static function create(Rule ...$rules): self
|
|
{
|
|
$validator = new self(
|
|
ValidatorDefaults::getFactory(),
|
|
ValidatorDefaults::getFormatter(),
|
|
ValidatorDefaults::getTranslator()
|
|
);
|
|
$validator->rules = $rules;
|
|
|
|
return $validator;
|
|
}
|
|
|
|
public function evaluate(mixed $input): Result
|
|
{
|
|
return $this->bindEvaluate($this->rule(), $this, $input);
|
|
}
|
|
|
|
public function isValid(mixed $input): bool
|
|
{
|
|
return $this->evaluate($input)->isValid;
|
|
}
|
|
|
|
/** @param array<string, mixed>|string|Throwable|null $template */
|
|
public function assert(mixed $input, array|string|Throwable|null $template = null): void
|
|
{
|
|
$result = $this->evaluate($input);
|
|
if ($result->isValid) {
|
|
return;
|
|
}
|
|
|
|
if ($template instanceof Throwable) {
|
|
throw $template;
|
|
}
|
|
|
|
$templates = $this->templates;
|
|
if (is_array($template)) {
|
|
$templates = $template;
|
|
} elseif (is_string($template)) {
|
|
$templates = ['__root__' => $template];
|
|
} elseif ($this->getTemplate() != null) {
|
|
$templates = ['__root__' => $this->getTemplate()];
|
|
}
|
|
|
|
throw new ValidationException(
|
|
$this->formatter->main($result, $templates, $this->translator),
|
|
$this->formatter->full($result, $templates, $this->translator),
|
|
$this->formatter->array($result, $templates, $this->translator),
|
|
);
|
|
}
|
|
|
|
/** @param array<string, mixed> $templates */
|
|
public function setTemplates(array $templates): self
|
|
{
|
|
$this->templates = $templates;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/** @return array<Rule> */
|
|
public function getRules(): array
|
|
{
|
|
return $this->rules;
|
|
}
|
|
|
|
/**
|
|
* @deprecated Use {@see isValid()} instead.
|
|
*/
|
|
public function validate(mixed $input): bool
|
|
{
|
|
return $this->evaluate($input)->isValid;
|
|
}
|
|
|
|
/**
|
|
* @deprecated Use {@see assert()} instead.
|
|
*/
|
|
public function check(mixed $input): void
|
|
{
|
|
$this->assert($input);
|
|
}
|
|
|
|
public function getName(): ?string
|
|
{
|
|
return $this->name;
|
|
}
|
|
|
|
public function setName(string $name): static
|
|
{
|
|
$this->name = $name;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getTemplate(): ?string
|
|
{
|
|
return $this->template;
|
|
}
|
|
|
|
public function setTemplate(string $template): static
|
|
{
|
|
$this->template = $template;
|
|
|
|
return $this;
|
|
}
|
|
|
|
private function rule(): Rule
|
|
{
|
|
if (count($this->rules) === 1) {
|
|
return current($this->rules);
|
|
}
|
|
|
|
return new AllOf(...$this->rules);
|
|
}
|
|
|
|
/**
|
|
* @param mixed[] $arguments
|
|
*/
|
|
public static function __callStatic(string $ruleName, array $arguments): self
|
|
{
|
|
return self::create()->__call($ruleName, $arguments);
|
|
}
|
|
|
|
/**
|
|
* @param mixed[] $arguments
|
|
*/
|
|
public function __call(string $ruleName, array $arguments): self
|
|
{
|
|
$this->rules[] = $this->factory->rule($ruleName, $arguments);
|
|
|
|
return $this;
|
|
}
|
|
}
|