+ */
+interface ExecutionContextInterface
+{
+ /**
+ * Adds a violation at the current node of the validation graph.
+ *
+ * @param string|\Stringable $message The error message as a string or a stringable object
+ * @param array $params The parameters substituted in the error message
+ *
+ * @return void
+ */
+ public function addViolation(string $message, array $params = []);
+
+ /**
+ * Returns a builder for adding a violation with extended information.
+ *
+ * Call {@link ConstraintViolationBuilderInterface::addViolation()} to
+ * add the violation when you're done with the configuration:
+ *
+ * $context->buildViolation('Please enter a number between %min% and %max%.')
+ * ->setParameter('%min%', '3')
+ * ->setParameter('%max%', '10')
+ * ->setTranslationDomain('number_validation')
+ * ->addViolation();
+ *
+ * @param string|\Stringable $message The error message as a string or a stringable object
+ * @param array $parameters The parameters substituted in the error message
+ */
+ public function buildViolation(string $message, array $parameters = []): ConstraintViolationBuilderInterface;
+
+ /**
+ * Returns the validator.
+ *
+ * Useful if you want to validate additional constraints:
+ *
+ * public function validate(mixed $value, Constraint $constraint): void
+ * {
+ * $validator = $this->context->getValidator();
+ *
+ * $violations = $validator->validate($value, new Length(['min' => 3]));
+ *
+ * if (count($violations) > 0) {
+ * // ...
+ * }
+ * }
+ */
+ public function getValidator(): ValidatorInterface;
+
+ /**
+ * Returns the currently validated object.
+ *
+ * If the validator is currently validating a class constraint, the
+ * object of that class is returned. If it is validating a property or
+ * getter constraint, the object that the property/getter belongs to is
+ * returned.
+ *
+ * In other cases, null is returned.
+ */
+ public function getObject(): ?object;
+
+ /**
+ * Warning: Should not be called by user code, to be used by the validator engine only.
+ *
+ * @param object|null $object The currently validated object
+ * @param string $propertyPath The property path to the current value
+ *
+ * @return void
+ */
+ public function setNode(mixed $value, ?object $object, ?MetadataInterface $metadata, string $propertyPath);
+
+ /**
+ * Warning: Should not be called by user code, to be used by the validator engine only.
+ *
+ * @param string|null $group The validated group
+ *
+ * @return void
+ */
+ public function setGroup(?string $group);
+
+ /**
+ * Warning: Should not be called by user code, to be used by the validator engine only.
+ *
+ * @return void
+ */
+ public function setConstraint(Constraint $constraint);
+
+ /**
+ * Warning: Should not be called by user code, to be used by the validator engine only.
+ *
+ * @param string $cacheKey The hash of the object
+ * @param string $groupHash The group's name or hash, if it is group
+ * sequence
+ *
+ * @return void
+ */
+ public function markGroupAsValidated(string $cacheKey, string $groupHash);
+
+ /**
+ * Warning: Should not be called by user code, to be used by the validator engine only.
+ *
+ * @param string $cacheKey The hash of the object
+ * @param string $groupHash The group's name or hash, if it is group
+ * sequence
+ */
+ public function isGroupValidated(string $cacheKey, string $groupHash): bool;
+
+ /**
+ * Warning: Should not be called by user code, to be used by the validator engine only.
+ *
+ * @param string $cacheKey The hash of the object
+ * @param string $constraintHash The hash of the constraint
+ *
+ * @return void
+ */
+ public function markConstraintAsValidated(string $cacheKey, string $constraintHash);
+
+ /**
+ * Warning: Should not be called by user code, to be used by the validator engine only.
+ *
+ * @param string $cacheKey The hash of the object
+ * @param string $constraintHash The hash of the constraint
+ */
+ public function isConstraintValidated(string $cacheKey, string $constraintHash): bool;
+
+ /**
+ * Warning: Should not be called by user code, to be used by the validator engine only.
+ *
+ * @param string $cacheKey The hash of the object
+ *
+ * @see ObjectInitializerInterface
+ */
+ public function markObjectAsInitialized(string $cacheKey): void;
+
+ /**
+ * Warning: Should not be called by user code, to be used by the validator engine only.
+ *
+ * @param string $cacheKey The hash of the object
+ *
+ * @see ObjectInitializerInterface
+ */
+ public function isObjectInitialized(string $cacheKey): bool;
+
+ /**
+ * Returns the violations generated by the validator so far.
+ */
+ public function getViolations(): ConstraintViolationListInterface;
+
+ /**
+ * Returns the value at which validation was started in the object graph.
+ *
+ * The validator, when given an object, traverses the properties and
+ * related objects and their properties. The root of the validation is the
+ * object from which the traversal started.
+ *
+ * The current value is returned by {@link getValue}.
+ */
+ public function getRoot(): mixed;
+
+ /**
+ * Returns the value that the validator is currently validating.
+ *
+ * If you want to retrieve the object that was originally passed to the
+ * validator, use {@link getRoot}.
+ */
+ public function getValue(): mixed;
+
+ /**
+ * Returns the metadata for the currently validated value.
+ *
+ * With the core implementation, this method returns a
+ * {@link Mapping\ClassMetadataInterface} instance if the current value is an object,
+ * a {@link Mapping\PropertyMetadata} instance if the current value is
+ * the value of a property and a {@link Mapping\GetterMetadata} instance if
+ * the validated value is the result of a getter method.
+ *
+ * If the validated value is neither of these, for example if the validator
+ * has been called with a plain value and constraint, this method returns
+ * null.
+ */
+ public function getMetadata(): ?MetadataInterface;
+
+ /**
+ * Returns the validation group that is currently being validated.
+ */
+ public function getGroup(): ?string;
+
+ /**
+ * Returns the class name of the current node.
+ *
+ * If the metadata of the current node does not implement
+ * {@link Mapping\ClassMetadataInterface} or if no metadata is available for the
+ * current node, this method returns null.
+ */
+ public function getClassName(): ?string;
+
+ /**
+ * Returns the property name of the current node.
+ *
+ * If the metadata of the current node does not implement
+ * {@link PropertyMetadataInterface} or if no metadata is available for the
+ * current node, this method returns null.
+ */
+ public function getPropertyName(): ?string;
+
+ /**
+ * Returns the property path to the value that the validator is currently
+ * validating.
+ *
+ * For example, take the following object graph:
+ *
+ *
+ * (Person)---($address: Address)---($street: string)
+ *
+ *
+ * When the Person instance is passed to the validator, the
+ * property path is initially empty. When the $address property
+ * of that person is validated, the property path is "address". When
+ * the $street property of the related Address instance
+ * is validated, the property path is "address.street".
+ *
+ * Properties of objects are prefixed with a dot in the property path.
+ * Indices of arrays or objects implementing the {@link \ArrayAccess}
+ * interface are enclosed in brackets. For example, if the property in
+ * the previous example is $addresses and contains an array
+ * of Address instance, the property path generated for the
+ * $street property of one of these addresses is for example
+ * "addresses[0].street".
+ *
+ * @param string $subPath Optional. The suffix appended to the current
+ * property path.
+ *
+ * @return string The current property path. The result may be an empty
+ * string if the validator is currently validating the
+ * root value of the validation graph.
+ */
+ public function getPropertyPath(string $subPath = ''): string;
+}
diff --git a/lib/symfony/validator/DataCollector/ValidatorDataCollector.php b/lib/symfony/validator/DataCollector/ValidatorDataCollector.php
new file mode 100644
index 0000000000..a50b16687a
--- /dev/null
+++ b/lib/symfony/validator/DataCollector/ValidatorDataCollector.php
@@ -0,0 +1,95 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\DataCollector;
+
+use Symfony\Component\Form\FormInterface;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpKernel\DataCollector\DataCollector;
+use Symfony\Component\HttpKernel\DataCollector\LateDataCollectorInterface;
+use Symfony\Component\Validator\Validator\TraceableValidator;
+use Symfony\Component\VarDumper\Caster\Caster;
+use Symfony\Component\VarDumper\Caster\ClassStub;
+use Symfony\Component\VarDumper\Cloner\Data;
+use Symfony\Component\VarDumper\Cloner\Stub;
+
+/**
+ * @author Maxime Steinhausser
+ *
+ * @final
+ */
+class ValidatorDataCollector extends DataCollector implements LateDataCollectorInterface
+{
+ private TraceableValidator $validator;
+
+ public function __construct(TraceableValidator $validator)
+ {
+ $this->validator = $validator;
+ $this->reset();
+ }
+
+ public function collect(Request $request, Response $response, ?\Throwable $exception = null): void
+ {
+ // Everything is collected once, on kernel terminate.
+ }
+
+ public function reset(): void
+ {
+ $this->data = [
+ 'calls' => $this->cloneVar([]),
+ 'violations_count' => 0,
+ ];
+ }
+
+ public function lateCollect(): void
+ {
+ $collected = $this->validator->getCollectedData();
+ $this->data['calls'] = $this->cloneVar($collected);
+ $this->data['violations_count'] = array_reduce($collected, fn ($previous, $item) => $previous + \count($item['violations']), 0);
+ }
+
+ public function getCalls(): Data
+ {
+ return $this->data['calls'];
+ }
+
+ public function getViolationsCount(): int
+ {
+ return $this->data['violations_count'];
+ }
+
+ public function getName(): string
+ {
+ return 'validator';
+ }
+
+ protected function getCasters(): array
+ {
+ return parent::getCasters() + [
+ \Exception::class => function (\Exception $e, array $a, Stub $s) {
+ foreach (["\0Exception\0previous", "\0Exception\0trace"] as $k) {
+ if (isset($a[$k])) {
+ unset($a[$k]);
+ ++$s->cut;
+ }
+ }
+
+ return $a;
+ },
+ FormInterface::class => fn (FormInterface $f, array $a) => [
+ Caster::PREFIX_VIRTUAL.'name' => $f->getName(),
+ Caster::PREFIX_VIRTUAL.'type_class' => new ClassStub($f->getConfig()->getType()->getInnerType()::class),
+ Caster::PREFIX_VIRTUAL.'data' => $f->getData(),
+ ],
+ ];
+ }
+}
diff --git a/lib/symfony/validator/DependencyInjection/AddAutoMappingConfigurationPass.php b/lib/symfony/validator/DependencyInjection/AddAutoMappingConfigurationPass.php
new file mode 100644
index 0000000000..3fcc84e7dc
--- /dev/null
+++ b/lib/symfony/validator/DependencyInjection/AddAutoMappingConfigurationPass.php
@@ -0,0 +1,87 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\DependencyInjection;
+
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\DependencyInjection\Reference;
+
+/**
+ * Injects the automapping configuration as last argument of loaders tagged with the "validator.auto_mapper" tag.
+ *
+ * @author Kévin Dunglas
+ */
+class AddAutoMappingConfigurationPass implements CompilerPassInterface
+{
+ /**
+ * @return void
+ */
+ public function process(ContainerBuilder $container)
+ {
+ if (!$container->hasParameter('validator.auto_mapping') || !$container->hasDefinition('validator.builder')) {
+ return;
+ }
+
+ $config = $container->getParameter('validator.auto_mapping');
+
+ $globalNamespaces = [];
+ $servicesToNamespaces = [];
+ foreach ($config as $namespace => $value) {
+ if ([] === $value['services']) {
+ $globalNamespaces[] = $namespace;
+
+ continue;
+ }
+
+ foreach ($value['services'] as $service) {
+ $servicesToNamespaces[$service][] = $namespace;
+ }
+ }
+
+ $validatorBuilder = $container->getDefinition('validator.builder');
+ foreach ($container->findTaggedServiceIds('validator.auto_mapper') as $id => $tags) {
+ $regexp = $this->getRegexp(array_merge($globalNamespaces, $servicesToNamespaces[$id] ?? []));
+ $validatorBuilder->addMethodCall('addLoader', [new Reference($id)]);
+ $container->getDefinition($id)->setArgument('$classValidatorRegexp', $regexp);
+ }
+
+ $container->getParameterBag()->remove('validator.auto_mapping');
+ }
+
+ /**
+ * Builds a regexp to check if a class is auto-mapped.
+ */
+ private function getRegexp(array $patterns): ?string
+ {
+ if (!$patterns) {
+ return null;
+ }
+
+ $regexps = [];
+ foreach ($patterns as $pattern) {
+ // Escape namespace
+ $regex = preg_quote(ltrim($pattern, '\\'));
+
+ // Wildcards * and **
+ $regex = strtr($regex, ['\\*\\*' => '.*?', '\\*' => '[^\\\\]*?']);
+
+ // If this class does not end by a slash, anchor the end
+ if (!str_ends_with($regex, '\\')) {
+ $regex .= '$';
+ }
+
+ $regexps[] = '^'.$regex;
+ }
+
+ return \sprintf('{%s}', implode('|', $regexps));
+ }
+}
diff --git a/lib/symfony/validator/DependencyInjection/AddConstraintValidatorsPass.php b/lib/symfony/validator/DependencyInjection/AddConstraintValidatorsPass.php
new file mode 100644
index 0000000000..4bcae00efa
--- /dev/null
+++ b/lib/symfony/validator/DependencyInjection/AddConstraintValidatorsPass.php
@@ -0,0 +1,50 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\DependencyInjection;
+
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\Compiler\ServiceLocatorTagPass;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\DependencyInjection\Reference;
+
+/**
+ * @author Johannes M. Schmitt
+ * @author Robin Chalas
+ */
+class AddConstraintValidatorsPass implements CompilerPassInterface
+{
+ /**
+ * @return void
+ */
+ public function process(ContainerBuilder $container)
+ {
+ if (!$container->hasDefinition('validator.validator_factory')) {
+ return;
+ }
+
+ $validators = [];
+ foreach ($container->findTaggedServiceIds('validator.constraint_validator', true) as $id => $attributes) {
+ $definition = $container->getDefinition($id);
+
+ if (isset($attributes[0]['alias'])) {
+ $validators[$attributes[0]['alias']] = new Reference($id);
+ }
+
+ $validators[$definition->getClass()] = new Reference($id);
+ }
+
+ $container
+ ->getDefinition('validator.validator_factory')
+ ->replaceArgument(0, ServiceLocatorTagPass::register($container, $validators))
+ ;
+ }
+}
diff --git a/lib/symfony/validator/DependencyInjection/AddValidatorInitializersPass.php b/lib/symfony/validator/DependencyInjection/AddValidatorInitializersPass.php
new file mode 100644
index 0000000000..d53e3c85e7
--- /dev/null
+++ b/lib/symfony/validator/DependencyInjection/AddValidatorInitializersPass.php
@@ -0,0 +1,40 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\DependencyInjection;
+
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\DependencyInjection\Reference;
+
+/**
+ * @author Fabien Potencier
+ * @author Robin Chalas
+ */
+class AddValidatorInitializersPass implements CompilerPassInterface
+{
+ /**
+ * @return void
+ */
+ public function process(ContainerBuilder $container)
+ {
+ if (!$container->hasDefinition('validator.builder')) {
+ return;
+ }
+
+ $initializers = [];
+ foreach ($container->findTaggedServiceIds('validator.initializer', true) as $id => $attributes) {
+ $initializers[] = new Reference($id);
+ }
+
+ $container->getDefinition('validator.builder')->addMethodCall('addObjectInitializers', [$initializers]);
+ }
+}
diff --git a/lib/symfony/validator/Exception/BadMethodCallException.php b/lib/symfony/validator/Exception/BadMethodCallException.php
new file mode 100644
index 0000000000..939161bff3
--- /dev/null
+++ b/lib/symfony/validator/Exception/BadMethodCallException.php
@@ -0,0 +1,21 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+/**
+ * Base BadMethodCallException for the Validator component.
+ *
+ * @author Bernhard Schussek
+ */
+class BadMethodCallException extends \BadMethodCallException implements ExceptionInterface
+{
+}
diff --git a/lib/symfony/validator/Exception/ConstraintDefinitionException.php b/lib/symfony/validator/Exception/ConstraintDefinitionException.php
new file mode 100644
index 0000000000..b24fdd68d2
--- /dev/null
+++ b/lib/symfony/validator/Exception/ConstraintDefinitionException.php
@@ -0,0 +1,16 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+class ConstraintDefinitionException extends ValidatorException
+{
+}
diff --git a/lib/symfony/validator/Exception/ExceptionInterface.php b/lib/symfony/validator/Exception/ExceptionInterface.php
new file mode 100644
index 0000000000..390e8c053f
--- /dev/null
+++ b/lib/symfony/validator/Exception/ExceptionInterface.php
@@ -0,0 +1,21 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+/**
+ * Base ExceptionInterface for the Validator component.
+ *
+ * @author Bernhard Schussek
+ */
+interface ExceptionInterface extends \Throwable
+{
+}
diff --git a/lib/symfony/validator/Exception/GroupDefinitionException.php b/lib/symfony/validator/Exception/GroupDefinitionException.php
new file mode 100644
index 0000000000..ab7e91d9e6
--- /dev/null
+++ b/lib/symfony/validator/Exception/GroupDefinitionException.php
@@ -0,0 +1,16 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+class GroupDefinitionException extends ValidatorException
+{
+}
diff --git a/lib/symfony/validator/Exception/InvalidArgumentException.php b/lib/symfony/validator/Exception/InvalidArgumentException.php
new file mode 100644
index 0000000000..22da39bb26
--- /dev/null
+++ b/lib/symfony/validator/Exception/InvalidArgumentException.php
@@ -0,0 +1,21 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+/**
+ * Base InvalidArgumentException for the Validator component.
+ *
+ * @author Bernhard Schussek
+ */
+class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
+{
+}
diff --git a/lib/symfony/validator/Exception/InvalidOptionsException.php b/lib/symfony/validator/Exception/InvalidOptionsException.php
new file mode 100644
index 0000000000..8a4fba25d0
--- /dev/null
+++ b/lib/symfony/validator/Exception/InvalidOptionsException.php
@@ -0,0 +1,32 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+class InvalidOptionsException extends ValidatorException
+{
+ private array $options;
+
+ public function __construct(string $message, array $options)
+ {
+ parent::__construct($message);
+
+ $this->options = $options;
+ }
+
+ /**
+ * @return array
+ */
+ public function getOptions()
+ {
+ return $this->options;
+ }
+}
diff --git a/lib/symfony/validator/Exception/LogicException.php b/lib/symfony/validator/Exception/LogicException.php
new file mode 100644
index 0000000000..41d0975c38
--- /dev/null
+++ b/lib/symfony/validator/Exception/LogicException.php
@@ -0,0 +1,16 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+class LogicException extends \LogicException implements ExceptionInterface
+{
+}
diff --git a/lib/symfony/validator/Exception/MappingException.php b/lib/symfony/validator/Exception/MappingException.php
new file mode 100644
index 0000000000..4c8c057b9f
--- /dev/null
+++ b/lib/symfony/validator/Exception/MappingException.php
@@ -0,0 +1,16 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+class MappingException extends ValidatorException
+{
+}
diff --git a/lib/symfony/validator/Exception/MissingOptionsException.php b/lib/symfony/validator/Exception/MissingOptionsException.php
new file mode 100644
index 0000000000..a7eda1457d
--- /dev/null
+++ b/lib/symfony/validator/Exception/MissingOptionsException.php
@@ -0,0 +1,32 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+class MissingOptionsException extends ValidatorException
+{
+ private array $options;
+
+ public function __construct(string $message, array $options)
+ {
+ parent::__construct($message);
+
+ $this->options = $options;
+ }
+
+ /**
+ * @return array
+ */
+ public function getOptions()
+ {
+ return $this->options;
+ }
+}
diff --git a/lib/symfony/validator/Exception/NoSuchMetadataException.php b/lib/symfony/validator/Exception/NoSuchMetadataException.php
new file mode 100644
index 0000000000..4cac74cf30
--- /dev/null
+++ b/lib/symfony/validator/Exception/NoSuchMetadataException.php
@@ -0,0 +1,19 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+/**
+ * @author Bernhard Schussek
+ */
+class NoSuchMetadataException extends ValidatorException
+{
+}
diff --git a/lib/symfony/validator/Exception/OutOfBoundsException.php b/lib/symfony/validator/Exception/OutOfBoundsException.php
new file mode 100644
index 0000000000..30906e8a82
--- /dev/null
+++ b/lib/symfony/validator/Exception/OutOfBoundsException.php
@@ -0,0 +1,21 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+/**
+ * Base OutOfBoundsException for the Validator component.
+ *
+ * @author Bernhard Schussek
+ */
+class OutOfBoundsException extends \OutOfBoundsException implements ExceptionInterface
+{
+}
diff --git a/lib/symfony/validator/Exception/RuntimeException.php b/lib/symfony/validator/Exception/RuntimeException.php
new file mode 100644
index 0000000000..df4a50c474
--- /dev/null
+++ b/lib/symfony/validator/Exception/RuntimeException.php
@@ -0,0 +1,21 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+/**
+ * Base RuntimeException for the Validator component.
+ *
+ * @author Bernhard Schussek
+ */
+class RuntimeException extends \RuntimeException implements ExceptionInterface
+{
+}
diff --git a/lib/symfony/validator/Exception/UnexpectedTypeException.php b/lib/symfony/validator/Exception/UnexpectedTypeException.php
new file mode 100644
index 0000000000..24ae4b3ac6
--- /dev/null
+++ b/lib/symfony/validator/Exception/UnexpectedTypeException.php
@@ -0,0 +1,20 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+class UnexpectedTypeException extends ValidatorException
+{
+ public function __construct(mixed $value, string $expectedType)
+ {
+ parent::__construct(\sprintf('Expected argument of type "%s", "%s" given', $expectedType, get_debug_type($value)));
+ }
+}
diff --git a/lib/symfony/validator/Exception/UnexpectedValueException.php b/lib/symfony/validator/Exception/UnexpectedValueException.php
new file mode 100644
index 0000000000..83a7e7a7d6
--- /dev/null
+++ b/lib/symfony/validator/Exception/UnexpectedValueException.php
@@ -0,0 +1,32 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+/**
+ * @author Christian Flothmann
+ */
+class UnexpectedValueException extends UnexpectedTypeException
+{
+ private string $expectedType;
+
+ public function __construct(mixed $value, string $expectedType)
+ {
+ parent::__construct($value, $expectedType);
+
+ $this->expectedType = $expectedType;
+ }
+
+ public function getExpectedType(): string
+ {
+ return $this->expectedType;
+ }
+}
diff --git a/lib/symfony/validator/Exception/UnsupportedMetadataException.php b/lib/symfony/validator/Exception/UnsupportedMetadataException.php
new file mode 100644
index 0000000000..aff569b957
--- /dev/null
+++ b/lib/symfony/validator/Exception/UnsupportedMetadataException.php
@@ -0,0 +1,19 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+/**
+ * @author Bernhard Schussek
+ */
+class UnsupportedMetadataException extends InvalidArgumentException
+{
+}
diff --git a/lib/symfony/validator/Exception/ValidationFailedException.php b/lib/symfony/validator/Exception/ValidationFailedException.php
new file mode 100644
index 0000000000..2106e0a0ba
--- /dev/null
+++ b/lib/symfony/validator/Exception/ValidationFailedException.php
@@ -0,0 +1,43 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+use Symfony\Component\Validator\ConstraintViolationListInterface;
+
+/**
+ * @author Jan Vernieuwe
+ */
+class ValidationFailedException extends RuntimeException
+{
+ private ConstraintViolationListInterface $violations;
+ private mixed $value;
+
+ public function __construct(mixed $value, ConstraintViolationListInterface $violations)
+ {
+ $this->violations = $violations;
+ $this->value = $value;
+ parent::__construct($violations);
+ }
+
+ /**
+ * @return mixed
+ */
+ public function getValue()
+ {
+ return $this->value;
+ }
+
+ public function getViolations(): ConstraintViolationListInterface
+ {
+ return $this->violations;
+ }
+}
diff --git a/lib/symfony/validator/Exception/ValidatorException.php b/lib/symfony/validator/Exception/ValidatorException.php
new file mode 100644
index 0000000000..28bd4704e8
--- /dev/null
+++ b/lib/symfony/validator/Exception/ValidatorException.php
@@ -0,0 +1,16 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Exception;
+
+class ValidatorException extends RuntimeException
+{
+}
diff --git a/lib/symfony/validator/GroupProviderInterface.php b/lib/symfony/validator/GroupProviderInterface.php
new file mode 100644
index 0000000000..7651ca2233
--- /dev/null
+++ b/lib/symfony/validator/GroupProviderInterface.php
@@ -0,0 +1,30 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator;
+
+use Symfony\Component\Validator\Constraints\GroupSequence;
+
+/**
+ * Defines the interface for a validation group provider.
+ *
+ * @author Yonel Ceruto
+ */
+interface GroupProviderInterface
+{
+ /**
+ * Returns which validation groups should be used for a certain state
+ * of the object.
+ *
+ * @return string[]|string[][]|GroupSequence
+ */
+ public function getGroups(object $object): array|GroupSequence;
+}
diff --git a/lib/symfony/validator/GroupSequenceProviderInterface.php b/lib/symfony/validator/GroupSequenceProviderInterface.php
new file mode 100644
index 0000000000..32fae2365c
--- /dev/null
+++ b/lib/symfony/validator/GroupSequenceProviderInterface.php
@@ -0,0 +1,28 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator;
+
+use Symfony\Component\Validator\Constraints\GroupSequence;
+
+/**
+ * Defines the interface for a group sequence provider.
+ */
+interface GroupSequenceProviderInterface
+{
+ /**
+ * Returns which validation groups should be used for a certain state
+ * of the object.
+ *
+ * @return string[]|string[][]|GroupSequence
+ */
+ public function getGroupSequence(): array|GroupSequence;
+}
diff --git a/lib/symfony/validator/LICENSE b/lib/symfony/validator/LICENSE
new file mode 100644
index 0000000000..0138f8f071
--- /dev/null
+++ b/lib/symfony/validator/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2004-present Fabien Potencier
+
+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/lib/symfony/validator/Mapping/AutoMappingStrategy.php b/lib/symfony/validator/Mapping/AutoMappingStrategy.php
new file mode 100644
index 0000000000..4012ddcff9
--- /dev/null
+++ b/lib/symfony/validator/Mapping/AutoMappingStrategy.php
@@ -0,0 +1,42 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping;
+
+/**
+ * Specifies how the auto-mapping feature should behave.
+ *
+ * @author Maxime Steinhausser
+ */
+final class AutoMappingStrategy
+{
+ /**
+ * Nothing explicitly set, rely on auto-mapping configured regex.
+ */
+ public const NONE = 0;
+
+ /**
+ * Explicitly enabled.
+ */
+ public const ENABLED = 1;
+
+ /**
+ * Explicitly disabled.
+ */
+ public const DISABLED = 2;
+
+ /**
+ * Not instantiable.
+ */
+ private function __construct()
+ {
+ }
+}
diff --git a/lib/symfony/validator/Mapping/CascadingStrategy.php b/lib/symfony/validator/Mapping/CascadingStrategy.php
new file mode 100644
index 0000000000..6bab8ac4e6
--- /dev/null
+++ b/lib/symfony/validator/Mapping/CascadingStrategy.php
@@ -0,0 +1,52 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping;
+
+/**
+ * Specifies whether an object should be cascaded.
+ *
+ * Cascading is relevant for any node type but class nodes. If such a node
+ * contains an object of value, and if cascading is enabled, then the node
+ * traverser will try to find class metadata for that object and validate the
+ * object against that metadata.
+ *
+ * If no metadata is found for a cascaded object, and if that object implements
+ * {@link \Traversable}, the node traverser will iterate over the object and
+ * cascade each object or collection contained within, unless iteration is
+ * prohibited by the specified {@link TraversalStrategy}.
+ *
+ * Although the constants currently represent a boolean switch, they are
+ * implemented as bit mask in order to allow future extensions.
+ *
+ * @author Bernhard Schussek
+ *
+ * @see TraversalStrategy
+ */
+class CascadingStrategy
+{
+ /**
+ * Specifies that a node should not be cascaded.
+ */
+ public const NONE = 1;
+
+ /**
+ * Specifies that a node should be cascaded.
+ */
+ public const CASCADE = 2;
+
+ /**
+ * Not instantiable.
+ */
+ private function __construct()
+ {
+ }
+}
diff --git a/lib/symfony/validator/Mapping/ClassMetadata.php b/lib/symfony/validator/Mapping/ClassMetadata.php
new file mode 100644
index 0000000000..bf164faac0
--- /dev/null
+++ b/lib/symfony/validator/Mapping/ClassMetadata.php
@@ -0,0 +1,519 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping;
+
+use Symfony\Component\Validator\Constraint;
+use Symfony\Component\Validator\Constraints\Cascade;
+use Symfony\Component\Validator\Constraints\Composite;
+use Symfony\Component\Validator\Constraints\GroupSequence;
+use Symfony\Component\Validator\Constraints\Traverse;
+use Symfony\Component\Validator\Constraints\Valid;
+use Symfony\Component\Validator\Exception\ConstraintDefinitionException;
+use Symfony\Component\Validator\Exception\GroupDefinitionException;
+use Symfony\Component\Validator\GroupSequenceProviderInterface;
+
+/**
+ * Default implementation of {@link ClassMetadataInterface}.
+ *
+ * This class supports serialization and cloning.
+ *
+ * @author Bernhard Schussek
+ * @author Fabien Potencier
+ */
+class ClassMetadata extends GenericMetadata implements ClassMetadataInterface
+{
+ /**
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getClassName()} instead.
+ */
+ public string $name;
+
+ /**
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getDefaultGroup()} instead.
+ */
+ public string $defaultGroup;
+
+ /**
+ * @var MemberMetadata[][]
+ *
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getPropertyMetadata()} instead.
+ */
+ public array $members = [];
+
+ /**
+ * @var PropertyMetadata[]
+ *
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getPropertyMetadata()} instead.
+ */
+ public array $properties = [];
+
+ /**
+ * @var GetterMetadata[]
+ *
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getPropertyMetadata()} instead.
+ */
+ public array $getters = [];
+
+ /**
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getGroupSequence()} instead.
+ */
+ public ?GroupSequence $groupSequence = null;
+
+ /**
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link isGroupSequenceProvider()} instead.
+ */
+ public bool $groupSequenceProvider = false;
+
+ /**
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getGroupProvider()} instead.
+ */
+ public ?string $groupProvider = null;
+
+ /**
+ * The strategy for traversing traversable objects.
+ *
+ * By default, only instances of {@link \Traversable} are traversed.
+ *
+ * @var TraversalStrategy::*
+ *
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getTraversalStrategy()} instead.
+ */
+ public int $traversalStrategy = TraversalStrategy::IMPLICIT;
+
+ private \ReflectionClass $reflClass;
+
+ public function __construct(string $class)
+ {
+ $this->name = $class;
+ // class name without namespace
+ if (false !== $nsSep = strrpos($class, '\\')) {
+ $this->defaultGroup = substr($class, $nsSep + 1);
+ } else {
+ $this->defaultGroup = $class;
+ }
+ }
+
+ public function __sleep(): array
+ {
+ $parentProperties = parent::__sleep();
+
+ // Don't store the cascading strategy. Classes never cascade.
+ unset($parentProperties[array_search('cascadingStrategy', $parentProperties)]);
+
+ return array_merge($parentProperties, [
+ 'getters',
+ 'groupSequence',
+ 'groupSequenceProvider',
+ 'groupProvider',
+ 'members',
+ 'name',
+ 'properties',
+ 'defaultGroup',
+ ]);
+ }
+
+ public function getClassName(): string
+ {
+ return $this->name;
+ }
+
+ /**
+ * Returns the name of the default group for this class.
+ *
+ * For each class, the group "Default" is an alias for the group
+ * "", where is the non-namespaced name of the
+ * class. All constraints implicitly or explicitly assigned to group
+ * "Default" belong to both of these groups, unless the class defines
+ * a group sequence.
+ *
+ * If a class defines a group sequence, validating the class in "Default"
+ * will validate the group sequence. The constraints assigned to "Default"
+ * can still be validated by validating the class in "".
+ */
+ public function getDefaultGroup(): string
+ {
+ return $this->defaultGroup;
+ }
+
+ /**
+ * If the constraint {@link Cascade} is added, the cascading strategy will be
+ * changed to {@link CascadingStrategy::CASCADE}.
+ *
+ * If the constraint {@link Traverse} is added, the traversal strategy will be
+ * changed. Depending on the $traverse property of that constraint,
+ * the traversal strategy will be set to one of the following:
+ *
+ * - {@link TraversalStrategy::IMPLICIT} by default
+ * - {@link TraversalStrategy::NONE} if $traverse is disabled
+ * - {@link TraversalStrategy::TRAVERSE} if $traverse is enabled
+ */
+ public function addConstraint(Constraint $constraint): static
+ {
+ $this->checkConstraint($constraint);
+
+ if ($constraint instanceof Traverse) {
+ if ($constraint->traverse) {
+ // If traverse is true, traversal should be explicitly enabled
+ $this->traversalStrategy = TraversalStrategy::TRAVERSE;
+ } else {
+ // If traverse is false, traversal should be explicitly disabled
+ $this->traversalStrategy = TraversalStrategy::NONE;
+ }
+
+ // The constraint is not added
+ return $this;
+ }
+
+ if ($constraint instanceof Cascade) {
+ $this->cascadingStrategy = CascadingStrategy::CASCADE;
+
+ foreach ($this->getReflectionClass()->getProperties() as $property) {
+ if (isset($constraint->exclude[$property->getName()])) {
+ continue;
+ }
+
+ if ($this->canCascade($property->getType())) {
+ $this->addPropertyConstraint($property->getName(), new Valid());
+ }
+ }
+
+ // The constraint is not added
+ return $this;
+ }
+
+ $constraint->addImplicitGroupName($this->getDefaultGroup());
+
+ parent::addConstraint($constraint);
+
+ return $this;
+ }
+
+ /**
+ * Adds a constraint to the given property.
+ *
+ * @return $this
+ */
+ public function addPropertyConstraint(string $property, Constraint $constraint): static
+ {
+ if (!isset($this->properties[$property])) {
+ $this->properties[$property] = new PropertyMetadata($this->getClassName(), $property);
+
+ $this->addPropertyMetadata($this->properties[$property]);
+ }
+
+ $constraint->addImplicitGroupName($this->getDefaultGroup());
+
+ $this->properties[$property]->addConstraint($constraint);
+
+ return $this;
+ }
+
+ /**
+ * @param Constraint[] $constraints
+ *
+ * @return $this
+ */
+ public function addPropertyConstraints(string $property, array $constraints): static
+ {
+ foreach ($constraints as $constraint) {
+ $this->addPropertyConstraint($property, $constraint);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Adds a constraint to the getter of the given property.
+ *
+ * The name of the getter is assumed to be the name of the property with an
+ * uppercased first letter and the prefix "get", "is" or "has".
+ *
+ * @return $this
+ */
+ public function addGetterConstraint(string $property, Constraint $constraint): static
+ {
+ if (!isset($this->getters[$property])) {
+ $this->getters[$property] = new GetterMetadata($this->getClassName(), $property);
+
+ $this->addPropertyMetadata($this->getters[$property]);
+ }
+
+ $constraint->addImplicitGroupName($this->getDefaultGroup());
+
+ $this->getters[$property]->addConstraint($constraint);
+
+ return $this;
+ }
+
+ /**
+ * Adds a constraint to the getter of the given property.
+ *
+ * @return $this
+ */
+ public function addGetterMethodConstraint(string $property, string $method, Constraint $constraint): static
+ {
+ if (!isset($this->getters[$property])) {
+ $this->getters[$property] = new GetterMetadata($this->getClassName(), $property, $method);
+
+ $this->addPropertyMetadata($this->getters[$property]);
+ }
+
+ $constraint->addImplicitGroupName($this->getDefaultGroup());
+
+ $this->getters[$property]->addConstraint($constraint);
+
+ return $this;
+ }
+
+ /**
+ * @param Constraint[] $constraints
+ *
+ * @return $this
+ */
+ public function addGetterConstraints(string $property, array $constraints): static
+ {
+ foreach ($constraints as $constraint) {
+ $this->addGetterConstraint($property, $constraint);
+ }
+
+ return $this;
+ }
+
+ /**
+ * @param Constraint[] $constraints
+ *
+ * @return $this
+ */
+ public function addGetterMethodConstraints(string $property, string $method, array $constraints): static
+ {
+ foreach ($constraints as $constraint) {
+ $this->addGetterMethodConstraint($property, $method, $constraint);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Merges the constraints of the given metadata into this object.
+ *
+ * @return void
+ */
+ public function mergeConstraints(self $source)
+ {
+ if ($source->isGroupSequenceProvider()) {
+ $this->setGroupProvider($source->getGroupProvider());
+ $this->setGroupSequenceProvider(true);
+ }
+
+ foreach ($source->getConstraints() as $constraint) {
+ $this->addConstraint(clone $constraint);
+ }
+
+ foreach ($source->getConstrainedProperties() as $property) {
+ foreach ($source->getPropertyMetadata($property) as $member) {
+ $member = clone $member;
+
+ foreach ($member->getConstraints() as $constraint) {
+ if (\in_array($constraint::DEFAULT_GROUP, $constraint->groups, true)) {
+ $member->constraintsByGroup[$this->getDefaultGroup()][] = $constraint;
+ }
+
+ $constraint->addImplicitGroupName($this->getDefaultGroup());
+ }
+
+ if ($member instanceof MemberMetadata && !$member->isPrivate($this->name)) {
+ $property = $member->getPropertyName();
+ $this->members[$property][] = $member;
+
+ if ($member instanceof PropertyMetadata && !isset($this->properties[$property])) {
+ $this->properties[$property] = $member;
+ } elseif ($member instanceof GetterMetadata && !isset($this->getters[$property])) {
+ $this->getters[$property] = $member;
+ }
+ } else {
+ $this->addPropertyMetadata($member);
+ }
+ }
+ }
+ }
+
+ public function hasPropertyMetadata(string $property): bool
+ {
+ return \array_key_exists($property, $this->members);
+ }
+
+ public function getPropertyMetadata(string $property): array
+ {
+ return $this->members[$property] ?? [];
+ }
+
+ public function getConstrainedProperties(): array
+ {
+ return array_keys($this->members);
+ }
+
+ /**
+ * Sets the default group sequence for this class.
+ *
+ * @param string[]|GroupSequence $groupSequence An array of group names
+ *
+ * @return $this
+ *
+ * @throws GroupDefinitionException
+ */
+ public function setGroupSequence(array|GroupSequence $groupSequence): static
+ {
+ if ($this->isGroupSequenceProvider()) {
+ throw new GroupDefinitionException('Defining a static group sequence is not allowed with a group sequence provider.');
+ }
+
+ if (\is_array($groupSequence)) {
+ $groupSequence = new GroupSequence($groupSequence);
+ }
+
+ if (\in_array(Constraint::DEFAULT_GROUP, $groupSequence->groups, true)) {
+ throw new GroupDefinitionException(\sprintf('The group "%s" is not allowed in group sequences.', Constraint::DEFAULT_GROUP));
+ }
+
+ if (!\in_array($this->getDefaultGroup(), $groupSequence->groups, true)) {
+ throw new GroupDefinitionException(\sprintf('The group "%s" is missing in the group sequence.', $this->getDefaultGroup()));
+ }
+
+ $this->groupSequence = $groupSequence;
+
+ return $this;
+ }
+
+ public function hasGroupSequence(): bool
+ {
+ return isset($this->groupSequence) && \count($this->groupSequence->groups) > 0;
+ }
+
+ public function getGroupSequence(): ?GroupSequence
+ {
+ return $this->groupSequence;
+ }
+
+ /**
+ * Returns a ReflectionClass instance for this class.
+ */
+ public function getReflectionClass(): \ReflectionClass
+ {
+ return $this->reflClass ??= new \ReflectionClass($this->getClassName());
+ }
+
+ /**
+ * Sets whether a group sequence provider should be used.
+ *
+ * @return void
+ *
+ * @throws GroupDefinitionException
+ */
+ public function setGroupSequenceProvider(bool $active)
+ {
+ if ($this->hasGroupSequence()) {
+ throw new GroupDefinitionException('Defining a group sequence provider is not allowed with a static group sequence.');
+ }
+
+ if (null === $this->groupProvider && !$this->getReflectionClass()->implementsInterface(GroupSequenceProviderInterface::class)) {
+ throw new GroupDefinitionException(\sprintf('Class "%s" must implement GroupSequenceProviderInterface.', $this->name));
+ }
+
+ $this->groupSequenceProvider = $active;
+ }
+
+ public function isGroupSequenceProvider(): bool
+ {
+ return $this->groupSequenceProvider;
+ }
+
+ public function setGroupProvider(?string $provider): void
+ {
+ $this->groupProvider = $provider;
+ }
+
+ public function getGroupProvider(): ?string
+ {
+ return $this->groupProvider;
+ }
+
+ public function getCascadingStrategy(): int
+ {
+ return $this->cascadingStrategy;
+ }
+
+ private function addPropertyMetadata(PropertyMetadataInterface $metadata): void
+ {
+ $property = $metadata->getPropertyName();
+
+ $this->members[$property][] = $metadata;
+ }
+
+ private function checkConstraint(Constraint $constraint): void
+ {
+ if (!\in_array(Constraint::CLASS_CONSTRAINT, (array) $constraint->getTargets(), true)) {
+ throw new ConstraintDefinitionException(\sprintf('The constraint "%s" cannot be put on classes.', get_debug_type($constraint)));
+ }
+
+ if ($constraint instanceof Composite) {
+ foreach ($constraint->getNestedConstraints() as $nestedConstraint) {
+ $this->checkConstraint($nestedConstraint);
+ }
+ }
+ }
+
+ private function canCascade(?\ReflectionType $type = null): bool
+ {
+ if (null === $type) {
+ return false;
+ }
+
+ if ($type instanceof \ReflectionIntersectionType) {
+ foreach ($type->getTypes() as $nestedType) {
+ if ($this->canCascade($nestedType)) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ if ($type instanceof \ReflectionUnionType) {
+ foreach ($type->getTypes() as $nestedType) {
+ if (!$this->canCascade($nestedType)) {
+ return false;
+ }
+ }
+
+ return true;
+ }
+
+ return $type instanceof \ReflectionNamedType && (\in_array($type->getName(), ['array', 'null'], true) || class_exists($type->getName()));
+ }
+}
diff --git a/lib/symfony/validator/Mapping/ClassMetadataInterface.php b/lib/symfony/validator/Mapping/ClassMetadataInterface.php
new file mode 100644
index 0000000000..6625e37e60
--- /dev/null
+++ b/lib/symfony/validator/Mapping/ClassMetadataInterface.php
@@ -0,0 +1,92 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping;
+
+use Symfony\Component\Validator\Constraints\GroupSequence;
+use Symfony\Component\Validator\GroupSequenceProviderInterface;
+
+/**
+ * Stores all metadata needed for validating objects of specific class.
+ *
+ * Most importantly, the metadata stores the constraints against which an object
+ * and its properties should be validated.
+ *
+ * Additionally, the metadata stores whether the "Default" group is overridden
+ * by a group sequence for that class and whether instances of that class
+ * should be traversed or not.
+ *
+ * @author Bernhard Schussek
+ *
+ * @see MetadataInterface
+ * @see GroupSequence
+ * @see GroupSequenceProviderInterface
+ * @see TraversalStrategy
+ *
+ * @method string|null getGroupProvider()
+ */
+interface ClassMetadataInterface extends MetadataInterface
+{
+ /**
+ * Returns the names of all constrained properties.
+ *
+ * @return string[]
+ */
+ public function getConstrainedProperties(): array;
+
+ /**
+ * Returns whether the "Default" group is overridden by a group sequence.
+ *
+ * If it is, you can access the group sequence with {@link getGroupSequence()}.
+ */
+ public function hasGroupSequence(): bool;
+
+ /**
+ * Returns the group sequence that overrides the "Default" group for this
+ * class.
+ */
+ public function getGroupSequence(): ?GroupSequence;
+
+ /**
+ * Returns whether the "Default" group is overridden by a dynamic group
+ * sequence obtained by the validated objects.
+ *
+ * If this method returns true, the class must implement
+ * {@link GroupSequenceProviderInterface}.
+ * This interface will be used to obtain the group sequence when an object
+ * of this class is validated.
+ */
+ public function isGroupSequenceProvider(): bool;
+
+ /**
+ * Check if there's any metadata attached to the given named property.
+ *
+ * @param string $property The property name
+ */
+ public function hasPropertyMetadata(string $property): bool;
+
+ /**
+ * Returns all metadata instances for the given named property.
+ *
+ * If your implementation does not support properties, throw an exception
+ * in this method (for example a BadMethodCallException).
+ *
+ * @param string $property The property name
+ *
+ * @return PropertyMetadataInterface[]
+ */
+ public function getPropertyMetadata(string $property): array;
+
+ /**
+ * Returns the name of the backing PHP class.
+ */
+ public function getClassName(): string;
+}
diff --git a/lib/symfony/validator/Mapping/Factory/BlackHoleMetadataFactory.php b/lib/symfony/validator/Mapping/Factory/BlackHoleMetadataFactory.php
new file mode 100644
index 0000000000..d46dccc66d
--- /dev/null
+++ b/lib/symfony/validator/Mapping/Factory/BlackHoleMetadataFactory.php
@@ -0,0 +1,37 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping\Factory;
+
+use Symfony\Component\Validator\Exception\LogicException;
+use Symfony\Component\Validator\Mapping\MetadataInterface;
+
+/**
+ * Metadata factory that does not store metadata.
+ *
+ * This implementation is useful if you want to validate values against
+ * constraints only and you don't need to add constraints to classes and
+ * properties.
+ *
+ * @author Fabien Potencier
+ */
+class BlackHoleMetadataFactory implements MetadataFactoryInterface
+{
+ public function getMetadataFor(mixed $value): MetadataInterface
+ {
+ throw new LogicException('This class does not support metadata.');
+ }
+
+ public function hasMetadataFor(mixed $value): bool
+ {
+ return false;
+ }
+}
diff --git a/lib/symfony/validator/Mapping/Factory/LazyLoadingMetadataFactory.php b/lib/symfony/validator/Mapping/Factory/LazyLoadingMetadataFactory.php
new file mode 100644
index 0000000000..f977f20dfd
--- /dev/null
+++ b/lib/symfony/validator/Mapping/Factory/LazyLoadingMetadataFactory.php
@@ -0,0 +1,159 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping\Factory;
+
+use Psr\Cache\CacheItemPoolInterface;
+use Symfony\Component\Validator\Exception\NoSuchMetadataException;
+use Symfony\Component\Validator\Mapping\ClassMetadata;
+use Symfony\Component\Validator\Mapping\Loader\LoaderInterface;
+use Symfony\Component\Validator\Mapping\MetadataInterface;
+
+/**
+ * Creates new {@link ClassMetadataInterface} instances.
+ *
+ * Whenever {@link getMetadataFor()} is called for the first time with a given
+ * class name or object of that class, a new metadata instance is created and
+ * returned. On subsequent requests for the same class, the same metadata
+ * instance will be returned.
+ *
+ * You can optionally pass a {@link LoaderInterface} instance to the constructor.
+ * Whenever a new metadata instance is created, it is passed to the loader,
+ * which can configure the metadata based on configuration loaded from the
+ * filesystem or a database. If you want to use multiple loaders, wrap them in a
+ * {@link LoaderChain}.
+ *
+ * You can also optionally pass a {@link CacheInterface} instance to the
+ * constructor. This cache will be used for persisting the generated metadata
+ * between multiple PHP requests.
+ *
+ * @author Bernhard Schussek
+ */
+class LazyLoadingMetadataFactory implements MetadataFactoryInterface
+{
+ protected $loader;
+ protected $cache;
+
+ /**
+ * The loaded metadata, indexed by class name.
+ *
+ * @var ClassMetadata[]
+ */
+ protected $loadedClasses = [];
+
+ public function __construct(?LoaderInterface $loader = null, ?CacheItemPoolInterface $cache = null)
+ {
+ $this->loader = $loader;
+ $this->cache = $cache;
+ }
+
+ /**
+ * If the method was called with the same class name (or an object of that
+ * class) before, the same metadata instance is returned.
+ *
+ * If the factory was configured with a cache, this method will first look
+ * for an existing metadata instance in the cache. If an existing instance
+ * is found, it will be returned without further ado.
+ *
+ * Otherwise, a new metadata instance is created. If the factory was
+ * configured with a loader, the metadata is passed to the
+ * {@link LoaderInterface::loadClassMetadata()} method for further
+ * configuration. At last, the new object is returned.
+ */
+ public function getMetadataFor(mixed $value): MetadataInterface
+ {
+ if (!\is_object($value) && !\is_string($value)) {
+ throw new NoSuchMetadataException(\sprintf('Cannot create metadata for non-objects. Got: "%s".', get_debug_type($value)));
+ }
+
+ $class = ltrim(\is_object($value) ? $value::class : $value, '\\');
+
+ if (isset($this->loadedClasses[$class])) {
+ return $this->loadedClasses[$class];
+ }
+
+ if (!class_exists($class) && !interface_exists($class, false)) {
+ throw new NoSuchMetadataException(\sprintf('The class or interface "%s" does not exist.', $class));
+ }
+
+ $cacheItem = $this->cache?->getItem($this->escapeClassName($class));
+ if ($cacheItem?->isHit()) {
+ $metadata = $cacheItem->get();
+
+ // Include constraints from the parent class
+ $this->mergeConstraints($metadata);
+
+ return $this->loadedClasses[$class] = $metadata;
+ }
+
+ $metadata = new ClassMetadata($class);
+
+ $this->loader?->loadClassMetadata($metadata);
+
+ if (null !== $cacheItem) {
+ $this->cache->save($cacheItem->set($metadata));
+ }
+
+ // Include constraints from the parent class
+ $this->mergeConstraints($metadata);
+
+ return $this->loadedClasses[$class] = $metadata;
+ }
+
+ private function mergeConstraints(ClassMetadata $metadata): void
+ {
+ if ($metadata->getReflectionClass()->isInterface()) {
+ return;
+ }
+
+ // Include constraints from the parent class
+ if ($parent = $metadata->getReflectionClass()->getParentClass()) {
+ $metadata->mergeConstraints($this->getMetadataFor($parent->name));
+ }
+
+ // Include constraints from all directly implemented interfaces
+ foreach ($metadata->getReflectionClass()->getInterfaces() as $interface) {
+ if ('Symfony\Component\Validator\GroupSequenceProviderInterface' === $interface->name) {
+ continue;
+ }
+
+ if ($parent && \in_array($interface->getName(), $parent->getInterfaceNames(), true)) {
+ continue;
+ }
+
+ $metadata->mergeConstraints($this->getMetadataFor($interface->name));
+ }
+ }
+
+ public function hasMetadataFor(mixed $value): bool
+ {
+ if (!\is_object($value) && !\is_string($value)) {
+ return false;
+ }
+
+ $class = ltrim(\is_object($value) ? $value::class : $value, '\\');
+
+ return class_exists($class) || interface_exists($class, false);
+ }
+
+ /**
+ * Replaces backslashes by dots in a class name.
+ */
+ private function escapeClassName(string $class): string
+ {
+ if (str_contains($class, '@')) {
+ // anonymous class: replace all PSR6-reserved characters
+ return str_replace(["\0", '\\', '/', '@', ':', '{', '}', '(', ')'], '.', $class);
+ }
+
+ return str_replace('\\', '.', $class);
+ }
+}
diff --git a/lib/symfony/validator/Mapping/Factory/MetadataFactoryInterface.php b/lib/symfony/validator/Mapping/Factory/MetadataFactoryInterface.php
new file mode 100644
index 0000000000..8e89d3b7da
--- /dev/null
+++ b/lib/symfony/validator/Mapping/Factory/MetadataFactoryInterface.php
@@ -0,0 +1,35 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping\Factory;
+
+use Symfony\Component\Validator\Exception\NoSuchMetadataException;
+use Symfony\Component\Validator\Mapping\MetadataInterface;
+
+/**
+ * Returns {@link \Symfony\Component\Validator\Mapping\MetadataInterface} instances for values.
+ *
+ * @author Bernhard Schussek
+ */
+interface MetadataFactoryInterface
+{
+ /**
+ * Returns the metadata for the given value.
+ *
+ * @throws NoSuchMetadataException If no metadata exists for the given value
+ */
+ public function getMetadataFor(mixed $value): MetadataInterface;
+
+ /**
+ * Returns whether the class is able to return metadata for the given value.
+ */
+ public function hasMetadataFor(mixed $value): bool;
+}
diff --git a/lib/symfony/validator/Mapping/GenericMetadata.php b/lib/symfony/validator/Mapping/GenericMetadata.php
new file mode 100644
index 0000000000..43992255c9
--- /dev/null
+++ b/lib/symfony/validator/Mapping/GenericMetadata.php
@@ -0,0 +1,226 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping;
+
+use Symfony\Component\Validator\Constraint;
+use Symfony\Component\Validator\Constraints\Cascade;
+use Symfony\Component\Validator\Constraints\DisableAutoMapping;
+use Symfony\Component\Validator\Constraints\EnableAutoMapping;
+use Symfony\Component\Validator\Constraints\Traverse;
+use Symfony\Component\Validator\Constraints\Valid;
+use Symfony\Component\Validator\Exception\ConstraintDefinitionException;
+
+/**
+ * A generic container of {@link Constraint} objects.
+ *
+ * This class supports serialization and cloning.
+ *
+ * @author Bernhard Schussek
+ */
+class GenericMetadata implements MetadataInterface
+{
+ /**
+ * @var Constraint[]
+ *
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getConstraints()} and {@link findConstraints()} instead.
+ */
+ public array $constraints = [];
+
+ /**
+ * @var array
+ *
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link findConstraints()} instead.
+ */
+ public array $constraintsByGroup = [];
+
+ /**
+ * The strategy for cascading objects.
+ *
+ * By default, objects are not cascaded.
+ *
+ * @var CascadingStrategy::*
+ *
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getCascadingStrategy()} instead.
+ */
+ public int $cascadingStrategy = CascadingStrategy::NONE;
+
+ /**
+ * The strategy for traversing traversable objects.
+ *
+ * By default, traversable objects are not traversed.
+ *
+ * @var TraversalStrategy::*
+ *
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getTraversalStrategy()} instead.
+ */
+ public int $traversalStrategy = TraversalStrategy::NONE;
+
+ /**
+ * Is auto-mapping enabled?
+ *
+ * @var AutoMappingStrategy::*
+ *
+ * @internal This property is public in order to reduce the size of the
+ * class' serialized representation. Do not access it. Use
+ * {@link getAutoMappingStrategy()} instead.
+ */
+ public int $autoMappingStrategy = AutoMappingStrategy::NONE;
+
+ /**
+ * Returns the names of the properties that should be serialized.
+ *
+ * @return string[]
+ */
+ public function __sleep(): array
+ {
+ return [
+ 'constraints',
+ 'constraintsByGroup',
+ 'cascadingStrategy',
+ 'traversalStrategy',
+ 'autoMappingStrategy',
+ ];
+ }
+
+ /**
+ * Clones this object.
+ */
+ public function __clone()
+ {
+ $constraints = $this->constraints;
+
+ $this->constraints = [];
+ $this->constraintsByGroup = [];
+
+ foreach ($constraints as $constraint) {
+ $this->addConstraint(clone $constraint);
+ }
+ }
+
+ /**
+ * Adds a constraint.
+ *
+ * If the constraint {@link Valid} is added, the cascading strategy will be
+ * changed to {@link CascadingStrategy::CASCADE}. Depending on the
+ * $traverse property of that constraint, the traversal strategy
+ * will be set to one of the following:
+ *
+ * - {@link TraversalStrategy::IMPLICIT} if $traverse is enabled
+ * - {@link TraversalStrategy::NONE} if $traverse is disabled
+ *
+ * @return $this
+ *
+ * @throws ConstraintDefinitionException When trying to add the {@link Cascade}
+ * or {@link Traverse} constraint
+ */
+ public function addConstraint(Constraint $constraint): static
+ {
+ if ($constraint instanceof Traverse || $constraint instanceof Cascade) {
+ throw new ConstraintDefinitionException(\sprintf('The constraint "%s" can only be put on classes. Please use "Symfony\Component\Validator\Constraints\Valid" instead.', get_debug_type($constraint)));
+ }
+
+ if ($constraint instanceof Valid && null === $constraint->groups) {
+ $this->cascadingStrategy = CascadingStrategy::CASCADE;
+
+ if ($constraint->traverse) {
+ $this->traversalStrategy = TraversalStrategy::IMPLICIT;
+ } else {
+ $this->traversalStrategy = TraversalStrategy::NONE;
+ }
+
+ return $this;
+ }
+
+ if ($constraint instanceof DisableAutoMapping || $constraint instanceof EnableAutoMapping) {
+ $this->autoMappingStrategy = $constraint instanceof EnableAutoMapping ? AutoMappingStrategy::ENABLED : AutoMappingStrategy::DISABLED;
+
+ // The constraint is not added
+ return $this;
+ }
+
+ $this->constraints[] = $constraint;
+
+ foreach ($constraint->groups as $group) {
+ $this->constraintsByGroup[$group][] = $constraint;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Adds an list of constraints.
+ *
+ * @param Constraint[] $constraints The constraints to add
+ *
+ * @return $this
+ */
+ public function addConstraints(array $constraints): static
+ {
+ foreach ($constraints as $constraint) {
+ $this->addConstraint($constraint);
+ }
+
+ return $this;
+ }
+
+ /**
+ * @return Constraint[]
+ */
+ public function getConstraints(): array
+ {
+ return $this->constraints;
+ }
+
+ /**
+ * Returns whether this element has any constraints.
+ */
+ public function hasConstraints(): bool
+ {
+ return \count($this->constraints) > 0;
+ }
+
+ /**
+ * Aware of the global group (* group).
+ *
+ * @return Constraint[]
+ */
+ public function findConstraints(string $group): array
+ {
+ return $this->constraintsByGroup[$group] ?? [];
+ }
+
+ public function getCascadingStrategy(): int
+ {
+ return $this->cascadingStrategy;
+ }
+
+ public function getTraversalStrategy(): int
+ {
+ return $this->traversalStrategy;
+ }
+
+ /**
+ * @see AutoMappingStrategy
+ */
+ public function getAutoMappingStrategy(): int
+ {
+ return $this->autoMappingStrategy;
+ }
+}
diff --git a/lib/symfony/validator/Mapping/GetterMetadata.php b/lib/symfony/validator/Mapping/GetterMetadata.php
new file mode 100644
index 0000000000..a4e2352ec0
--- /dev/null
+++ b/lib/symfony/validator/Mapping/GetterMetadata.php
@@ -0,0 +1,74 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping;
+
+use Symfony\Component\Validator\Exception\ValidatorException;
+
+/**
+ * Stores all metadata needed for validating a class property via its getter
+ * method.
+ *
+ * A property getter is any method that is equal to the property's name,
+ * prefixed with "get", "is" or "has". That method will be used to access the
+ * property's value.
+ *
+ * The getter will be invoked by reflection, so the access of private and
+ * protected getters is supported.
+ *
+ * This class supports serialization and cloning.
+ *
+ * @author Bernhard Schussek
+ *
+ * @see PropertyMetadataInterface
+ */
+class GetterMetadata extends MemberMetadata
+{
+ /**
+ * @param string $class The class the getter is defined on
+ * @param string $property The property which the getter returns
+ * @param string|null $method The method that is called to retrieve the value being validated (null for auto-detection)
+ *
+ * @throws ValidatorException
+ */
+ public function __construct(string $class, string $property, ?string $method = null)
+ {
+ if (null === $method) {
+ $getMethod = 'get'.ucfirst($property);
+ $isMethod = 'is'.ucfirst($property);
+ $hasMethod = 'has'.ucfirst($property);
+
+ if (method_exists($class, $getMethod)) {
+ $method = $getMethod;
+ } elseif (method_exists($class, $isMethod)) {
+ $method = $isMethod;
+ } elseif (method_exists($class, $hasMethod)) {
+ $method = $hasMethod;
+ } else {
+ throw new ValidatorException(\sprintf('Neither of these methods exist in class "%s": "%s", "%s", "%s".', $class, $getMethod, $isMethod, $hasMethod));
+ }
+ } elseif (!method_exists($class, $method)) {
+ throw new ValidatorException(\sprintf('The "%s()" method does not exist in class "%s".', $method, $class));
+ }
+
+ parent::__construct($class, $method, $property);
+ }
+
+ public function getPropertyValue(mixed $object): mixed
+ {
+ return $this->newReflectionMember($object)->invoke($object);
+ }
+
+ protected function newReflectionMember(object|string $objectOrClassName): \ReflectionMethod|\ReflectionProperty
+ {
+ return new \ReflectionMethod($objectOrClassName, $this->getName());
+ }
+}
diff --git a/lib/symfony/validator/Mapping/Loader/AbstractLoader.php b/lib/symfony/validator/Mapping/Loader/AbstractLoader.php
new file mode 100644
index 0000000000..5c81baa5dd
--- /dev/null
+++ b/lib/symfony/validator/Mapping/Loader/AbstractLoader.php
@@ -0,0 +1,107 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping\Loader;
+
+use Symfony\Component\Validator\Attribute\HasNamedArguments;
+use Symfony\Component\Validator\Constraint;
+use Symfony\Component\Validator\Exception\MappingException;
+
+/**
+ * Base loader for validation metadata.
+ *
+ * This loader supports the loading of constraints from Symfony's default
+ * namespace (see {@link DEFAULT_NAMESPACE}) using the short class names of
+ * those constraints. Constraints can also be loaded using their fully
+ * qualified class names. At last, namespace aliases can be defined to load
+ * constraints with the syntax "alias:ShortName".
+ *
+ * @author Bernhard Schussek
+ */
+abstract class AbstractLoader implements LoaderInterface
+{
+ /**
+ * The namespace to load constraints from by default.
+ */
+ public const DEFAULT_NAMESPACE = '\\Symfony\\Component\\Validator\\Constraints\\';
+
+ protected $namespaces = [];
+
+ /**
+ * @var array
+ */
+ private array $namedArgumentsCache = [];
+
+ /**
+ * Adds a namespace alias.
+ *
+ * The namespace alias can be used to reference constraints from specific
+ * namespaces in {@link newConstraint()}:
+ *
+ * $this->addNamespaceAlias('mynamespace', '\\Acme\\Package\\Constraints\\');
+ *
+ * $constraint = $this->newConstraint('mynamespace:NotNull');
+ *
+ * @return void
+ */
+ protected function addNamespaceAlias(string $alias, string $namespace)
+ {
+ $this->namespaces[$alias] = $namespace;
+ }
+
+ /**
+ * Creates a new constraint instance for the given constraint name.
+ *
+ * @param string $name The constraint name. Either a constraint relative
+ * to the default constraint namespace, or a fully
+ * qualified class name. Alternatively, the constraint
+ * may be preceded by a namespace alias and a colon.
+ * The namespace alias must have been defined using
+ * {@link addNamespaceAlias()}.
+ * @param mixed $options The constraint options
+ *
+ * @throws MappingException If the namespace prefix is undefined
+ */
+ protected function newConstraint(string $name, mixed $options = null): Constraint
+ {
+ if (str_contains($name, '\\') && class_exists($name)) {
+ $className = $name;
+ } elseif (str_contains($name, ':')) {
+ [$prefix, $className] = explode(':', $name, 2);
+
+ if (!isset($this->namespaces[$prefix])) {
+ throw new MappingException(\sprintf('Undefined namespace prefix "%s".', $prefix));
+ }
+
+ $className = $this->namespaces[$prefix].$className;
+ } else {
+ $className = self::DEFAULT_NAMESPACE.$name;
+ }
+
+ if ($this->namedArgumentsCache[$className] ??= (bool) (new \ReflectionMethod($className, '__construct'))->getAttributes(HasNamedArguments::class)) {
+ if (null === $options) {
+ return new $className();
+ }
+
+ if (!\is_array($options)) {
+ return new $className($options);
+ }
+
+ if (1 === \count($options) && isset($options['value'])) {
+ return new $className($options['value']);
+ }
+
+ return new $className(...$options);
+ }
+
+ return new $className($options);
+ }
+}
diff --git a/lib/symfony/validator/Mapping/Loader/AnnotationLoader.php b/lib/symfony/validator/Mapping/Loader/AnnotationLoader.php
new file mode 100644
index 0000000000..f90f9ce5e6
--- /dev/null
+++ b/lib/symfony/validator/Mapping/Loader/AnnotationLoader.php
@@ -0,0 +1,159 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping\Loader;
+
+use Doctrine\Common\Annotations\Reader;
+use Symfony\Component\Validator\Constraint;
+use Symfony\Component\Validator\Constraints\Callback;
+use Symfony\Component\Validator\Constraints\GroupSequence;
+use Symfony\Component\Validator\Constraints\GroupSequenceProvider;
+use Symfony\Component\Validator\Exception\MappingException;
+use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+/**
+ * Loads validation metadata using a Doctrine annotation {@link Reader} or using PHP 8 attributes.
+ *
+ * @deprecated since Symfony 6.4, use {@see AttributeLoader} instead
+ *
+ * @author Bernhard Schussek
+ * @author Alexander M. Turek
+ */
+class AnnotationLoader implements LoaderInterface
+{
+ /**
+ * @deprecated since Symfony 6.4, this property will be removed in 7.0
+ *
+ * @var Reader|null
+ */
+ protected $reader;
+
+ public function __construct(?Reader $reader = null)
+ {
+ $this->reader = $reader;
+ }
+
+ public function loadClassMetadata(ClassMetadata $metadata): bool
+ {
+ $reflClass = $metadata->getReflectionClass();
+ $className = $reflClass->name;
+ $success = false;
+
+ foreach ($this->getAnnotations($reflClass) as $constraint) {
+ if ($constraint instanceof GroupSequence) {
+ $metadata->setGroupSequence($constraint->groups);
+ } elseif ($constraint instanceof GroupSequenceProvider) {
+ $metadata->setGroupProvider($constraint->provider);
+ $metadata->setGroupSequenceProvider(true);
+ } elseif ($constraint instanceof Constraint) {
+ $metadata->addConstraint($constraint);
+ }
+
+ $success = true;
+ }
+
+ foreach ($reflClass->getProperties() as $property) {
+ if ($property->getDeclaringClass()->name === $className) {
+ foreach ($this->getAnnotations($property) as $constraint) {
+ if ($constraint instanceof Constraint) {
+ $metadata->addPropertyConstraint($property->name, $constraint);
+ }
+
+ $success = true;
+ }
+ }
+ }
+
+ foreach ($reflClass->getMethods() as $method) {
+ if ($method->getDeclaringClass()->name === $className) {
+ foreach ($this->getAnnotations($method) as $constraint) {
+ if ($constraint instanceof Callback) {
+ $constraint->callback = $method->getName();
+
+ $metadata->addConstraint($constraint);
+ } elseif ($constraint instanceof Constraint) {
+ if (preg_match('/^(get|is|has)(.+)$/i', $method->name, $matches)) {
+ $metadata->addGetterMethodConstraint(lcfirst($matches[2]), $matches[0], $constraint);
+ } else {
+ throw new MappingException(\sprintf('The constraint on "%s::%s()" cannot be added. Constraints can only be added on methods beginning with "get", "is" or "has".', $className, $method->name));
+ }
+ }
+
+ $success = true;
+ }
+ }
+ }
+
+ return $success;
+ }
+
+ private function getAnnotations(\ReflectionMethod|\ReflectionClass|\ReflectionProperty $reflection): iterable
+ {
+ $dedup = [];
+
+ foreach ($reflection->getAttributes(GroupSequence::class) as $attribute) {
+ $dedup[] = $attribute->newInstance();
+ yield $attribute->newInstance();
+ }
+ foreach ($reflection->getAttributes(GroupSequenceProvider::class) as $attribute) {
+ $dedup[] = $attribute->newInstance();
+ yield $attribute->newInstance();
+ }
+ foreach ($reflection->getAttributes(Constraint::class, \ReflectionAttribute::IS_INSTANCEOF) as $attribute) {
+ $dedup[] = $attribute->newInstance();
+ yield $attribute->newInstance();
+ }
+ if (!$this->reader) {
+ return;
+ }
+
+ $annotations = [];
+
+ if ($reflection instanceof \ReflectionClass && $annotations = $this->reader->getClassAnnotations($reflection)) {
+ $this->triggerDeprecationIfAnnotationIsUsed($annotations, \sprintf('Class "%s"', $reflection->getName()));
+ }
+ if ($reflection instanceof \ReflectionMethod && $annotations = $this->reader->getMethodAnnotations($reflection)) {
+ $this->triggerDeprecationIfAnnotationIsUsed($annotations, \sprintf('Method "%s::%s()"', $reflection->getDeclaringClass()->getName(), $reflection->getName()));
+ }
+ if ($reflection instanceof \ReflectionProperty && $annotations = $this->reader->getPropertyAnnotations($reflection)) {
+ $this->triggerDeprecationIfAnnotationIsUsed($annotations, \sprintf('Property "%s::$%s"', $reflection->getDeclaringClass()->getName(), $reflection->getName()));
+ }
+
+ foreach ($dedup as $annotation) {
+ if ($annotation instanceof Constraint) {
+ $annotation->groups; // trigger initialization of the "groups" property
+ }
+ }
+
+ foreach ($annotations as $annotation) {
+ if ($annotation instanceof Constraint) {
+ $annotation->groups; // trigger initialization of the "groups" property
+ }
+ if (!\in_array($annotation, $dedup, false)) {
+ yield $annotation;
+ }
+ }
+ }
+
+ private function triggerDeprecationIfAnnotationIsUsed(array $annotations, string $messagePrefix): void
+ {
+ foreach ($annotations as $annotation) {
+ if (
+ $annotation instanceof Constraint
+ || $annotation instanceof GroupSequence
+ || $annotation instanceof GroupSequenceProvider
+ ) {
+ trigger_deprecation('symfony/validator', '6.4', \sprintf('%s uses Doctrine Annotations to configure validation constraints, which is deprecated. Use PHP attributes instead.', $messagePrefix));
+ break;
+ }
+ }
+ }
+}
diff --git a/lib/symfony/validator/Mapping/Loader/AttributeLoader.php b/lib/symfony/validator/Mapping/Loader/AttributeLoader.php
new file mode 100644
index 0000000000..2a8a75e1e6
--- /dev/null
+++ b/lib/symfony/validator/Mapping/Loader/AttributeLoader.php
@@ -0,0 +1,27 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Validator\Mapping\Loader;
+
+/**
+ * Loads validation metadata using PHP attributes.
+ *
+ * @author Bernhard Schussek
+ * @author Alexander M. Turek
+ * @author Alexandre Daubois