vendor/symfony/validator/Mapping/Factory/LazyLoadingMetadataFactory.php line 52

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\Validator\Mapping\Factory;
  14. use Psr\Cache\CacheItemPoolInterface;
  15. use Symfony\Component\Validator\Exception\NoSuchMetadataException;
  16. use Symfony\Component\Validator\Mapping\ClassMetadata;
  17. use Symfony\Component\Validator\Mapping\Loader\LoaderInterface;
  18. use Symfony\Component\Validator\Mapping\MetadataInterface;
  20. /**
  21.  * Creates new {@link ClassMetadataInterface} instances.
  22.  *
  23.  * Whenever {@link getMetadataFor()} is called for the first time with a given
  24.  * class name or object of that class, a new metadata instance is created and
  25.  * returned. On subsequent requests for the same class, the same metadata
  26.  * instance will be returned.
  27.  *
  28.  * You can optionally pass a {@link LoaderInterface} instance to the constructor.
  29.  * Whenever a new metadata instance is created, it is passed to the loader,
  30.  * which can configure the metadata based on configuration loaded from the
  31.  * filesystem or a database. If you want to use multiple loaders, wrap them in a
  32.  * {@link LoaderChain}.
  33.  *
  34.  * You can also optionally pass a {@link CacheInterface} instance to the
  35.  * constructor. This cache will be used for persisting the generated metadata
  36.  * between multiple PHP requests.
  37.  *
  38.  * @author Bernhard Schussek <bschussek@gmail.com>
  39.  */
  40. class LazyLoadingMetadataFactory implements MetadataFactoryInterface
  41. {
  42.     protected $loader;
  43.     protected $cache;
  45.     /**
  46.      * The loaded metadata, indexed by class name.
  47.      *
  48.      * @var ClassMetadata[]
  49.      */
  50.     protected $loadedClasses = [];
  52.     public function __construct(LoaderInterface $loader = null, CacheItemPoolInterface $cache = null)
  53.     {
  54.         $this->loader = $loader;
  55.         $this->cache = $cache;
  56.     }
  58.     /**
  59.      * {@inheritdoc}
  60.      *
  61.      * If the method was called with the same class name (or an object of that
  62.      * class) before, the same metadata instance is returned.
  63.      *
  64.      * If the factory was configured with a cache, this method will first look
  65.      * for an existing metadata instance in the cache. If an existing instance
  66.      * is found, it will be returned without further ado.
  67.      *
  68.      * Otherwise, a new metadata instance is created. If the factory was
  69.      * configured with a loader, the metadata is passed to the
  70.      * {@link LoaderInterface::loadClassMetadata()} method for further
  71.      * configuration. At last, the new object is returned.
  72.      */
  73.     public function getMetadataFor(mixed $value): MetadataInterface
  74.     {
  75.         if (!\is_object($value) && !\is_string($value)) {
  76.             throw new NoSuchMetadataException(sprintf('Cannot create metadata for non-objects. Got: "%s".', get_debug_type($value)));
  77.         }
  79.         $class = ltrim(\is_object($value) ? \get_class($value) : $value, '\\');
  81.         if (isset($this->loadedClasses[$class])) {
  82.             return $this->loadedClasses[$class];
  83.         }
  85.         if (!class_exists($class) && !interface_exists($class, false)) {
  86.             throw new NoSuchMetadataException(sprintf('The class or interface "%s" does not exist.', $class));
  87.         }
  89.         $cacheItem = $this->cache?->getItem($this->escapeClassName($class));
  90.         if ($cacheItem?->isHit()) {
  91.             $metadata = $cacheItem->get();
  93.             // Include constraints from the parent class
  94.             $this->mergeConstraints($metadata);
  96.             return $this->loadedClasses[$class] = $metadata;
  97.         }
  99.         $metadata = new ClassMetadata($class);
  101.         $this->loader?->loadClassMetadata($metadata);
  103.         if (null !== $cacheItem) {
  104.             $this->cache->save($cacheItem->set($metadata));
  105.         }
  107.         // Include constraints from the parent class
  108.         $this->mergeConstraints($metadata);
  110.         return $this->loadedClasses[$class] = $metadata;
  111.     }
  113.     private function mergeConstraints(ClassMetadata $metadata)
  114.     {
  115.         if ($metadata->getReflectionClass()->isInterface()) {
  116.             return;
  117.         }
  119.         // Include constraints from the parent class
  120.         if ($parent = $metadata->getReflectionClass()->getParentClass()) {
  121.             $metadata->mergeConstraints($this->getMetadataFor($parent->name));
  122.         }
  124.         // Include constraints from all directly implemented interfaces
  125.         foreach ($metadata->getReflectionClass()->getInterfaces() as $interface) {
  126.             if ('Symfony\Component\Validator\GroupSequenceProviderInterface' === $interface->name) {
  127.                 continue;
  128.             }
  130.             if ($parent && \in_array($interface->getName(), $parent->getInterfaceNames(), true)) {
  131.                 continue;
  132.             }
  134.             $metadata->mergeConstraints($this->getMetadataFor($interface->name));
  135.         }
  136.     }
  138.     /**
  139.      * {@inheritdoc}
  140.      */
  141.     public function hasMetadataFor(mixed $value): bool
  142.     {
  143.         if (!\is_object($value) && !\is_string($value)) {
  144.             return false;
  145.         }
  147.         $class = ltrim(\is_object($value) ? \get_class($value) : $value, '\\');
  149.         return class_exists($class) || interface_exists($class, false);
  150.     }
  152.     /**
  153.      * Replaces backslashes by dots in a class name.
  154.      */
  155.     private function escapeClassName(string $class): string
  156.     {
  157.         if (str_contains($class, '@')) {
  158.             // anonymous class: replace all PSR6-reserved characters
  159.             return str_replace(["\0", '\\', '/', '@', ':', '{', '}', '(', ')'], '.', $class);
  160.         }
  162.         return str_replace('\\', '.', $class);
  163.     }
  164. }