mirror of
https://github.com/Respect/Validation.git
synced 2026-03-16 15:25:45 +01:00
94ddfcd0bdThe constructor of `Result` has many arguments, but that's not the primary reason why I'm making this change. I want to change the constructor, and it will become more complicated, so having this named constructor will be useful in the next refactoring. With this change, I also made the `id` mandatory. That made the constructor look neater and most to promote almost all properties to the constructor. Another change was removing the `fromAdjacent` method, which was quite confusing. I created the `asAdjacentOf` method, which is a bit clearer. If anything, it makes all static methods named constructors. It will be a bit more verbose, but more intuitive.
83 lines
2.5 KiB
PHP
83 lines
2.5 KiB
PHP
<?php
|
|
|
|
/*
|
|
* Copyright (c) Alexandre Gomes Gaigalas <alganet@gmail.com>
|
|
* SPDX-License-Identifier: MIT
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Respect\Validation\Rules;
|
|
|
|
use Attribute;
|
|
use Ramsey\Uuid\Rfc4122\FieldsInterface;
|
|
use Ramsey\Uuid\Uuid as RamseyUuid;
|
|
use Ramsey\Uuid\UuidInterface;
|
|
use Respect\Validation\Exceptions\InvalidRuleConstructorException;
|
|
use Respect\Validation\Exceptions\MissingComposerDependencyException;
|
|
use Respect\Validation\Message\Template;
|
|
use Respect\Validation\Result;
|
|
use Respect\Validation\Rule;
|
|
use Throwable;
|
|
|
|
use function class_exists;
|
|
use function is_string;
|
|
|
|
#[Attribute(Attribute::TARGET_PROPERTY | Attribute::IS_REPEATABLE)]
|
|
#[Template(
|
|
'{{subject}} must be a valid UUID',
|
|
'{{subject}} must not be a valid UUID',
|
|
self::TEMPLATE_STANDARD,
|
|
)]
|
|
#[Template(
|
|
'{{subject}} must be a valid UUID version {{version|raw}}',
|
|
'{{subject}} must not be a valid UUID version {{version|raw}}',
|
|
self::TEMPLATE_VERSION,
|
|
)]
|
|
final class Uuid implements Rule
|
|
{
|
|
public const string TEMPLATE_VERSION = '__version__';
|
|
|
|
public function __construct(
|
|
private readonly int|null $version = null,
|
|
) {
|
|
if (!class_exists(RamseyUuid::class)) {
|
|
throw new MissingComposerDependencyException('Uuid rule requires ramsey/uuid', '=');
|
|
}
|
|
|
|
if ($version !== null && !$this->isSupportedVersion($version)) {
|
|
throw new InvalidRuleConstructorException(
|
|
'Only versions 1 to 8 are supported: %d given',
|
|
(string) $version,
|
|
);
|
|
}
|
|
}
|
|
|
|
public function evaluate(mixed $input): Result
|
|
{
|
|
$template = $this->version ? self::TEMPLATE_VERSION : self::TEMPLATE_STANDARD;
|
|
$parameters = ['version' => $this->version];
|
|
|
|
if (!is_string($input) && !($input instanceof UuidInterface)) {
|
|
return Result::failed($input, $this, $parameters, $template);
|
|
}
|
|
|
|
try {
|
|
$uuid = is_string($input) ? RamseyUuid::fromString($input) : $input;
|
|
} catch (Throwable) {
|
|
return Result::failed($input, $this, $parameters, $template);
|
|
}
|
|
|
|
$fields = $uuid->getFields();
|
|
$uuidVersion = $fields instanceof FieldsInterface ? $fields->getVersion() : null;
|
|
|
|
$hasPassed = $this->version ? $uuidVersion === $this->version : $uuidVersion !== null;
|
|
|
|
return Result::of($hasPassed, $input, $this, $parameters, $template);
|
|
}
|
|
|
|
private function isSupportedVersion(int $version): bool
|
|
{
|
|
return $version >= 1 && $version <= 8;
|
|
}
|
|
}
|