vendor/doctrine/persistence/src/Persistence/Mapping/AbstractClassMetadataFactory.php line 87

Open in your IDE?
  1. <?php
  2. declare(strict_types=1);
  3. namespace Doctrine\Persistence\Mapping;
  4. use Doctrine\Persistence\Mapping\Driver\MappingDriver;
  5. use Doctrine\Persistence\Proxy;
  6. use Psr\Cache\CacheItemPoolInterface;
  7. use ReflectionClass;
  8. use ReflectionException;
  9. use function array_combine;
  10. use function array_keys;
  11. use function array_map;
  12. use function array_reverse;
  13. use function array_unshift;
  14. use function assert;
  15. use function class_exists;
  16. use function ltrim;
  17. use function str_replace;
  18. use function strpos;
  19. use function strrpos;
  20. use function substr;
  21. /**
  22.  * The ClassMetadataFactory is used to create ClassMetadata objects that contain all the
  23.  * metadata mapping informations of a class which describes how a class should be mapped
  24.  * to a relational database.
  25.  *
  26.  * This class was abstracted from the ORM ClassMetadataFactory.
  27.  *
  28.  * @template CMTemplate of ClassMetadata
  29.  * @template-implements ClassMetadataFactory<CMTemplate>
  30.  */
  31. abstract class AbstractClassMetadataFactory implements ClassMetadataFactory
  32. {
  33.     /**
  34.      * Salt used by specific Object Manager implementation.
  35.      *
  36.      * @var string
  37.      */
  38.     protected $cacheSalt '__CLASSMETADATA__';
  39.     /** @var CacheItemPoolInterface|null */
  40.     private $cache;
  41.     /**
  42.      * @var array<string, ClassMetadata>
  43.      * @psalm-var CMTemplate[]
  44.      */
  45.     private $loadedMetadata = [];
  46.     /** @var bool */
  47.     protected $initialized false;
  48.     /** @var ReflectionService|null */
  49.     private $reflectionService null;
  50.     /** @var ProxyClassNameResolver|null */
  51.     private $proxyClassNameResolver null;
  52.     public function setCache(CacheItemPoolInterface $cache): void
  53.     {
  54.         $this->cache $cache;
  55.     }
  56.     final protected function getCache(): ?CacheItemPoolInterface
  57.     {
  58.         return $this->cache;
  59.     }
  60.     /**
  61.      * Returns an array of all the loaded metadata currently in memory.
  62.      *
  63.      * @return ClassMetadata[]
  64.      * @psalm-return CMTemplate[]
  65.      */
  66.     public function getLoadedMetadata()
  67.     {
  68.         return $this->loadedMetadata;
  69.     }
  70.     /**
  71.      * {@inheritDoc}
  72.      */
  73.     public function getAllMetadata()
  74.     {
  75.         if (! $this->initialized) {
  76.             $this->initialize();
  77.         }
  78.         $driver   $this->getDriver();
  79.         $metadata = [];
  80.         foreach ($driver->getAllClassNames() as $className) {
  81.             $metadata[] = $this->getMetadataFor($className);
  82.         }
  83.         return $metadata;
  84.     }
  85.     public function setProxyClassNameResolver(ProxyClassNameResolver $resolver): void
  86.     {
  87.         $this->proxyClassNameResolver $resolver;
  88.     }
  89.     /**
  90.      * Lazy initialization of this stuff, especially the metadata driver,
  91.      * since these are not needed at all when a metadata cache is active.
  92.      *
  93.      * @return void
  94.      */
  95.     abstract protected function initialize();
  96.     /**
  97.      * Returns the mapping driver implementation.
  98.      *
  99.      * @return MappingDriver
  100.      */
  101.     abstract protected function getDriver();
  102.     /**
  103.      * Wakes up reflection after ClassMetadata gets unserialized from cache.
  104.      *
  105.      * @psalm-param CMTemplate $class
  106.      *
  107.      * @return void
  108.      */
  109.     abstract protected function wakeupReflection(
  110.         ClassMetadata $class,
  111.         ReflectionService $reflService
  112.     );
  113.     /**
  114.      * Initializes Reflection after ClassMetadata was constructed.
  115.      *
  116.      * @psalm-param CMTemplate $class
  117.      *
  118.      * @return void
  119.      */
  120.     abstract protected function initializeReflection(
  121.         ClassMetadata $class,
  122.         ReflectionService $reflService
  123.     );
  124.     /**
  125.      * Checks whether the class metadata is an entity.
  126.      *
  127.      * This method should return false for mapped superclasses or embedded classes.
  128.      *
  129.      * @psalm-param CMTemplate $class
  130.      *
  131.      * @return bool
  132.      */
  133.     abstract protected function isEntity(ClassMetadata $class);
  134.     /**
  135.      * Removes the prepended backslash of a class string to conform with how php outputs class names
  136.      *
  137.      * @psalm-param class-string $className
  138.      *
  139.      * @psalm-return class-string
  140.      */
  141.     private function normalizeClassName(string $className): string
  142.     {
  143.         return ltrim($className'\\');
  144.     }
  145.     /**
  146.      * {@inheritDoc}
  147.      *
  148.      * @throws ReflectionException
  149.      * @throws MappingException
  150.      */
  151.     public function getMetadataFor(string $className)
  152.     {
  153.         $className $this->normalizeClassName($className);
  154.         if (isset($this->loadedMetadata[$className])) {
  155.             return $this->loadedMetadata[$className];
  156.         }
  157.         if (class_exists($classNamefalse) && (new ReflectionClass($className))->isAnonymous()) {
  158.             throw MappingException::classIsAnonymous($className);
  159.         }
  160.         if (! class_exists($classNamefalse) && strpos($className':') !== false) {
  161.             throw MappingException::nonExistingClass($className);
  162.         }
  163.         $realClassName $this->getRealClass($className);
  164.         if (isset($this->loadedMetadata[$realClassName])) {
  165.             // We do not have the alias name in the map, include it
  166.             return $this->loadedMetadata[$className] = $this->loadedMetadata[$realClassName];
  167.         }
  168.         try {
  169.             if ($this->cache !== null) {
  170.                 $cached $this->cache->getItem($this->getCacheKey($realClassName))->get();
  171.                 if ($cached instanceof ClassMetadata) {
  172.                     /** @psalm-var CMTemplate $cached */
  173.                     $this->loadedMetadata[$realClassName] = $cached;
  174.                     $this->wakeupReflection($cached$this->getReflectionService());
  175.                 } else {
  176.                     $loadedMetadata $this->loadMetadata($realClassName);
  177.                     $classNames     array_combine(
  178.                         array_map([$this'getCacheKey'], $loadedMetadata),
  179.                         $loadedMetadata
  180.                     );
  181.                     foreach ($this->cache->getItems(array_keys($classNames)) as $item) {
  182.                         if (! isset($classNames[$item->getKey()])) {
  183.                             continue;
  184.                         }
  185.                         $item->set($this->loadedMetadata[$classNames[$item->getKey()]]);
  186.                         $this->cache->saveDeferred($item);
  187.                     }
  188.                     $this->cache->commit();
  189.                 }
  190.             } else {
  191.                 $this->loadMetadata($realClassName);
  192.             }
  193.         } catch (MappingException $loadingException) {
  194.             $fallbackMetadataResponse $this->onNotFoundMetadata($realClassName);
  195.             if ($fallbackMetadataResponse === null) {
  196.                 throw $loadingException;
  197.             }
  198.             $this->loadedMetadata[$realClassName] = $fallbackMetadataResponse;
  199.         }
  200.         if ($className !== $realClassName) {
  201.             // We do not have the alias name in the map, include it
  202.             $this->loadedMetadata[$className] = $this->loadedMetadata[$realClassName];
  203.         }
  204.         return $this->loadedMetadata[$className];
  205.     }
  206.     /**
  207.      * {@inheritDoc}
  208.      */
  209.     public function hasMetadataFor(string $className)
  210.     {
  211.         $className $this->normalizeClassName($className);
  212.         return isset($this->loadedMetadata[$className]);
  213.     }
  214.     /**
  215.      * Sets the metadata descriptor for a specific class.
  216.      *
  217.      * NOTE: This is only useful in very special cases, like when generating proxy classes.
  218.      *
  219.      * @psalm-param class-string $className
  220.      * @psalm-param CMTemplate $class
  221.      *
  222.      * @return void
  223.      */
  224.     public function setMetadataFor(string $classNameClassMetadata $class)
  225.     {
  226.         $this->loadedMetadata[$this->normalizeClassName($className)] = $class;
  227.     }
  228.     /**
  229.      * Gets an array of parent classes for the given entity class.
  230.      *
  231.      * @psalm-param class-string $name
  232.      *
  233.      * @return string[]
  234.      * @psalm-return class-string[]
  235.      */
  236.     protected function getParentClasses(string $name)
  237.     {
  238.         // Collect parent classes, ignoring transient (not-mapped) classes.
  239.         $parentClasses = [];
  240.         foreach (array_reverse($this->getReflectionService()->getParentClasses($name)) as $parentClass) {
  241.             if ($this->getDriver()->isTransient($parentClass)) {
  242.                 continue;
  243.             }
  244.             $parentClasses[] = $parentClass;
  245.         }
  246.         return $parentClasses;
  247.     }
  248.     /**
  249.      * Loads the metadata of the class in question and all it's ancestors whose metadata
  250.      * is still not loaded.
  251.      *
  252.      * Important: The class $name does not necessarily exist at this point here.
  253.      * Scenarios in a code-generation setup might have access to XML/YAML
  254.      * Mapping files without the actual PHP code existing here. That is why the
  255.      * {@see \Doctrine\Persistence\Mapping\ReflectionService} interface
  256.      * should be used for reflection.
  257.      *
  258.      * @param string $name The name of the class for which the metadata should get loaded.
  259.      * @psalm-param class-string $name
  260.      *
  261.      * @return array<int, string>
  262.      */
  263.     protected function loadMetadata(string $name)
  264.     {
  265.         if (! $this->initialized) {
  266.             $this->initialize();
  267.         }
  268.         $loaded = [];
  269.         $parentClasses   $this->getParentClasses($name);
  270.         $parentClasses[] = $name;
  271.         // Move down the hierarchy of parent classes, starting from the topmost class
  272.         $parent          null;
  273.         $rootEntityFound false;
  274.         $visited         = [];
  275.         $reflService     $this->getReflectionService();
  276.         foreach ($parentClasses as $className) {
  277.             if (isset($this->loadedMetadata[$className])) {
  278.                 $parent $this->loadedMetadata[$className];
  279.                 if ($this->isEntity($parent)) {
  280.                     $rootEntityFound true;
  281.                     array_unshift($visited$className);
  282.                 }
  283.                 continue;
  284.             }
  285.             $class $this->newClassMetadataInstance($className);
  286.             $this->initializeReflection($class$reflService);
  287.             $this->doLoadMetadata($class$parent$rootEntityFound$visited);
  288.             $this->loadedMetadata[$className] = $class;
  289.             $parent $class;
  290.             if ($this->isEntity($class)) {
  291.                 $rootEntityFound true;
  292.                 array_unshift($visited$className);
  293.             }
  294.             $this->wakeupReflection($class$reflService);
  295.             $loaded[] = $className;
  296.         }
  297.         return $loaded;
  298.     }
  299.     /**
  300.      * Provides a fallback hook for loading metadata when loading failed due to reflection/mapping exceptions
  301.      *
  302.      * Override this method to implement a fallback strategy for failed metadata loading
  303.      *
  304.      * @return ClassMetadata|null
  305.      * @psalm-return CMTemplate|null
  306.      */
  307.     protected function onNotFoundMetadata(string $className)
  308.     {
  309.         return null;
  310.     }
  311.     /**
  312.      * Actually loads the metadata from the underlying metadata.
  313.      *
  314.      * @param string[] $nonSuperclassParents All parent class names that are
  315.      *                                       not marked as mapped superclasses.
  316.      * @psalm-param CMTemplate $class
  317.      * @psalm-param CMTemplate|null $parent
  318.      *
  319.      * @return void
  320.      */
  321.     abstract protected function doLoadMetadata(
  322.         ClassMetadata $class,
  323.         ?ClassMetadata $parent,
  324.         bool $rootEntityFound,
  325.         array $nonSuperclassParents
  326.     );
  327.     /**
  328.      * Creates a new ClassMetadata instance for the given class name.
  329.      *
  330.      * @psalm-param class-string<T> $className
  331.      *
  332.      * @return ClassMetadata<T>
  333.      * @psalm-return CMTemplate
  334.      *
  335.      * @template T of object
  336.      */
  337.     abstract protected function newClassMetadataInstance(string $className);
  338.     /**
  339.      * {@inheritDoc}
  340.      */
  341.     public function isTransient(string $className)
  342.     {
  343.         if (! $this->initialized) {
  344.             $this->initialize();
  345.         }
  346.         if (class_exists($classNamefalse) && (new ReflectionClass($className))->isAnonymous()) {
  347.             return false;
  348.         }
  349.         if (! class_exists($classNamefalse) && strpos($className':') !== false) {
  350.             throw MappingException::nonExistingClass($className);
  351.         }
  352.         /** @psalm-var class-string $className */
  353.         return $this->getDriver()->isTransient($className);
  354.     }
  355.     /**
  356.      * Sets the reflectionService.
  357.      *
  358.      * @return void
  359.      */
  360.     public function setReflectionService(ReflectionService $reflectionService)
  361.     {
  362.         $this->reflectionService $reflectionService;
  363.     }
  364.     /**
  365.      * Gets the reflection service associated with this metadata factory.
  366.      *
  367.      * @return ReflectionService
  368.      */
  369.     public function getReflectionService()
  370.     {
  371.         if ($this->reflectionService === null) {
  372.             $this->reflectionService = new RuntimeReflectionService();
  373.         }
  374.         return $this->reflectionService;
  375.     }
  376.     protected function getCacheKey(string $realClassName): string
  377.     {
  378.         return str_replace('\\''__'$realClassName) . $this->cacheSalt;
  379.     }
  380.     /**
  381.      * Gets the real class name of a class name that could be a proxy.
  382.      *
  383.      * @psalm-param class-string<Proxy<T>>|class-string<T> $class
  384.      *
  385.      * @psalm-return class-string<T>
  386.      *
  387.      * @template T of object
  388.      */
  389.     private function getRealClass(string $class): string
  390.     {
  391.         if ($this->proxyClassNameResolver === null) {
  392.             $this->createDefaultProxyClassNameResolver();
  393.         }
  394.         assert($this->proxyClassNameResolver !== null);
  395.         return $this->proxyClassNameResolver->resolveClassName($class);
  396.     }
  397.     private function createDefaultProxyClassNameResolver(): void
  398.     {
  399.         $this->proxyClassNameResolver = new class implements ProxyClassNameResolver {
  400.             /**
  401.              * @psalm-param class-string<Proxy<T>>|class-string<T> $className
  402.              *
  403.              * @psalm-return class-string<T>
  404.              *
  405.              * @template T of object
  406.              */
  407.             public function resolveClassName(string $className): string
  408.             {
  409.                 $pos strrpos($className'\\' Proxy::MARKER '\\');
  410.                 if ($pos === false) {
  411.                     /** @psalm-var class-string<T> */
  412.                     return $className;
  413.                 }
  414.                 /** @psalm-var class-string<T> */
  415.                 return substr($className$pos Proxy::MARKER_LENGTH 2);
  416.             }
  417.         };
  418.     }
  419. }