Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. ValidatorBuilder.php

class ValidatorBuilder

@author Bernhard Schussek <bschussek@gmail.com>

Hierarchy

  • class \Symfony\Component\Validator\ValidatorBuilder

Expanded class hierarchy of ValidatorBuilder

File

vendor/symfony/validator/ValidatorBuilder.php, line 40

Namespace

Symfony\Component\Validator
View source
class ValidatorBuilder {
    private array $initializers = [];
    private array $loaders = [];
    private array $xmlMappings = [];
    private array $yamlMappings = [];
    private array $methodMappings = [];
    private bool $enableAttributeMapping = false;
    private ?MetadataFactoryInterface $metadataFactory = null;
    private ConstraintValidatorFactoryInterface $validatorFactory;
    private ?ContainerInterface $groupProviderLocator = null;
    private ?CacheItemPoolInterface $mappingCache = null;
    private ?TranslatorInterface $translator = null;
    private ?string $translationDomain = null;
    
    /**
     * Adds an object initializer to the validator.
     *
     * @return $this
     */
    public function addObjectInitializer(ObjectInitializerInterface $initializer) : static {
        $this->initializers[] = $initializer;
        return $this;
    }
    
    /**
     * Adds a list of object initializers to the validator.
     *
     * @param ObjectInitializerInterface[] $initializers
     *
     * @return $this
     */
    public function addObjectInitializers(array $initializers) : static {
        $this->initializers = array_merge($this->initializers, $initializers);
        return $this;
    }
    
    /**
     * Adds an XML constraint mapping file to the validator.
     *
     * @return $this
     */
    public function addXmlMapping(string $path) : static {
        if (null !== $this->metadataFactory) {
            throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
        }
        $this->xmlMappings[] = $path;
        return $this;
    }
    
    /**
     * Adds a list of XML constraint mapping files to the validator.
     *
     * @param string[] $paths The paths to the mapping files
     *
     * @return $this
     */
    public function addXmlMappings(array $paths) : static {
        if (null !== $this->metadataFactory) {
            throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
        }
        $this->xmlMappings = array_merge($this->xmlMappings, $paths);
        return $this;
    }
    
    /**
     * Adds a YAML constraint mapping file to the validator.
     *
     * @param string $path The path to the mapping file
     *
     * @return $this
     */
    public function addYamlMapping(string $path) : static {
        if (null !== $this->metadataFactory) {
            throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
        }
        $this->yamlMappings[] = $path;
        return $this;
    }
    
    /**
     * Adds a list of YAML constraint mappings file to the validator.
     *
     * @param string[] $paths The paths to the mapping files
     *
     * @return $this
     */
    public function addYamlMappings(array $paths) : static {
        if (null !== $this->metadataFactory) {
            throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
        }
        $this->yamlMappings = array_merge($this->yamlMappings, $paths);
        return $this;
    }
    
    /**
     * Enables constraint mapping using the given static method.
     *
     * @return $this
     */
    public function addMethodMapping(string $methodName) : static {
        if (null !== $this->metadataFactory) {
            throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
        }
        $this->methodMappings[] = $methodName;
        return $this;
    }
    
    /**
     * Enables constraint mapping using the given static methods.
     *
     * @param string[] $methodNames The names of the methods
     *
     * @return $this
     */
    public function addMethodMappings(array $methodNames) : static {
        if (null !== $this->metadataFactory) {
            throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
        }
        $this->methodMappings = array_merge($this->methodMappings, $methodNames);
        return $this;
    }
    
    /**
     * Enables attribute-based constraint mapping.
     *
     * @return $this
     */
    public function enableAttributeMapping() : static {
        if (null !== $this->metadataFactory) {
            throw new ValidatorException('You cannot enable attribute mapping after setting a custom metadata factory. Configure your metadata factory instead.');
        }
        $this->enableAttributeMapping = true;
        return $this;
    }
    
    /**
     * Disables attribute-based constraint mapping.
     *
     * @return $this
     */
    public function disableAttributeMapping() : static {
        $this->enableAttributeMapping = false;
        return $this;
    }
    
    /**
     * Sets the class metadata factory used by the validator.
     *
     * @return $this
     */
    public function setMetadataFactory(MetadataFactoryInterface $metadataFactory) : static {
        if (\count($this->xmlMappings) > 0 || \count($this->yamlMappings) > 0 || \count($this->methodMappings) > 0 || $this->enableAttributeMapping) {
            throw new ValidatorException('You cannot set a custom metadata factory after adding custom mappings. You should do either of both.');
        }
        $this->metadataFactory = $metadataFactory;
        return $this;
    }
    
    /**
     * Sets the cache for caching class metadata.
     *
     * @return $this
     */
    public function setMappingCache(CacheItemPoolInterface $cache) : static {
        if (null !== $this->metadataFactory) {
            throw new ValidatorException('You cannot set a custom mapping cache after setting a custom metadata factory. Configure your metadata factory instead.');
        }
        $this->mappingCache = $cache;
        return $this;
    }
    
    /**
     * Sets the constraint validator factory used by the validator.
     *
     * @return $this
     */
    public function setConstraintValidatorFactory(ConstraintValidatorFactoryInterface $validatorFactory) : static {
        $this->validatorFactory = $validatorFactory;
        return $this;
    }
    
    /**
     * @return $this
     */
    public function setGroupProviderLocator(ContainerInterface $groupProviderLocator) : static {
        $this->groupProviderLocator = $groupProviderLocator;
        return $this;
    }
    
    /**
     * Sets the translator used for translating violation messages.
     *
     * @return $this
     */
    public function setTranslator(TranslatorInterface $translator) : static {
        $this->translator = $translator;
        return $this;
    }
    
    /**
     * Sets the default translation domain of violation messages.
     *
     * The same message can have different translations in different domains.
     * Pass the domain that is used for violation messages by default to this
     * method.
     *
     * @return $this
     */
    public function setTranslationDomain(?string $translationDomain) : static {
        $this->translationDomain = $translationDomain;
        return $this;
    }
    
    /**
     * @return $this
     */
    public function addLoader(LoaderInterface $loader) : static {
        $this->loaders[] = $loader;
        return $this;
    }
    
    /**
     * @return LoaderInterface[]
     */
    public function getLoaders() : array {
        $loaders = [];
        foreach ($this->xmlMappings as $xmlMapping) {
            $loaders[] = new XmlFileLoader($xmlMapping);
        }
        foreach ($this->yamlMappings as $yamlMappings) {
            $loaders[] = new YamlFileLoader($yamlMappings);
        }
        foreach ($this->methodMappings as $methodName) {
            $loaders[] = new StaticMethodLoader($methodName);
        }
        if ($this->enableAttributeMapping) {
            $loaders[] = new AttributeLoader();
        }
        return array_merge($loaders, $this->loaders);
    }
    
    /**
     * Builds and returns a new validator object.
     */
    public function getValidator() : ValidatorInterface {
        $metadataFactory = $this->metadataFactory;
        if (!$metadataFactory) {
            $loaders = $this->getLoaders();
            $loader = null;
            if (\count($loaders) > 1) {
                $loader = new LoaderChain($loaders);
            }
            elseif (1 === \count($loaders)) {
                $loader = $loaders[0];
            }
            $metadataFactory = new LazyLoadingMetadataFactory($loader, $this->mappingCache);
        }
        $validatorFactory = $this->validatorFactory ?? new ConstraintValidatorFactory();
        $translator = $this->translator;
        if (null === $translator) {
            $translator = new class  implements TranslatorInterface, LocaleAwareInterface {
                use TranslatorTrait;

};
            // Force the locale to be 'en' when no translator is provided rather than relying on the Intl default locale
            // This avoids depending on Intl or the stub implementation being available. It also ensures that Symfony
            // validation messages are pluralized properly even when the default locale gets changed because they are in
            // English.
            $translator->setLocale('en');
        }
        $contextFactory = new ExecutionContextFactory($translator, $this->translationDomain);
        return new RecursiveValidator($contextFactory, $metadataFactory, $validatorFactory, $this->initializers, $this->groupProviderLocator);
    }

}

Members

Title Sort descending Modifiers Object type Summary
ValidatorBuilder::$enableAttributeMapping private property
ValidatorBuilder::$groupProviderLocator private property
ValidatorBuilder::$initializers private property
ValidatorBuilder::$loaders private property
ValidatorBuilder::$mappingCache private property
ValidatorBuilder::$metadataFactory private property
ValidatorBuilder::$methodMappings private property
ValidatorBuilder::$translationDomain private property
ValidatorBuilder::$translator private property
ValidatorBuilder::$validatorFactory private property
ValidatorBuilder::$xmlMappings private property
ValidatorBuilder::$yamlMappings private property
ValidatorBuilder::addLoader public function
ValidatorBuilder::addMethodMapping public function Enables constraint mapping using the given static method.
ValidatorBuilder::addMethodMappings public function Enables constraint mapping using the given static methods.
ValidatorBuilder::addObjectInitializer public function Adds an object initializer to the validator.
ValidatorBuilder::addObjectInitializers public function Adds a list of object initializers to the validator.
ValidatorBuilder::addXmlMapping public function Adds an XML constraint mapping file to the validator.
ValidatorBuilder::addXmlMappings public function Adds a list of XML constraint mapping files to the validator.
ValidatorBuilder::addYamlMapping public function Adds a YAML constraint mapping file to the validator.
ValidatorBuilder::addYamlMappings public function Adds a list of YAML constraint mappings file to the validator.
ValidatorBuilder::disableAttributeMapping public function Disables attribute-based constraint mapping.
ValidatorBuilder::enableAttributeMapping public function Enables attribute-based constraint mapping.
ValidatorBuilder::getLoaders public function
ValidatorBuilder::getValidator public function Builds and returns a new validator object.
ValidatorBuilder::setConstraintValidatorFactory public function Sets the constraint validator factory used by the validator.
ValidatorBuilder::setGroupProviderLocator public function
ValidatorBuilder::setMappingCache public function Sets the cache for caching class metadata.
ValidatorBuilder::setMetadataFactory public function Sets the class metadata factory used by the validator.
ValidatorBuilder::setTranslationDomain public function Sets the default translation domain of violation messages.
ValidatorBuilder::setTranslator public function Sets the translator used for translating violation messages.

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal