vendor/api-platform/core/src/Api/IdentifiersExtractor.php line 54

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the API Platform project.
  5.  *
  6.  * (c) Kévin Dunglas <dunglas@gmail.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. declare(strict_types=1);
  14. namespace ApiPlatform\Core\Api;
  16. use ApiPlatform\Core\Exception\RuntimeException;
  17. use ApiPlatform\Core\Metadata\Property\Factory\PropertyMetadataFactoryInterface;
  18. use ApiPlatform\Core\Metadata\Property\Factory\PropertyNameCollectionFactoryInterface;
  19. use ApiPlatform\Core\Util\ResourceClassInfoTrait;
  20. use Symfony\Component\PropertyAccess\PropertyAccess;
  21. use Symfony\Component\PropertyAccess\PropertyAccessorInterface;
  23. /**
  24.  * {@inheritdoc}
  25.  *
  26.  * @author Antoine Bluchet <soyuka@gmail.com>
  27.  */
  28. final class IdentifiersExtractor implements IdentifiersExtractorInterface
  29. {
  30.     use ResourceClassInfoTrait;
  32.     private $propertyNameCollectionFactory;
  33.     private $propertyMetadataFactory;
  34.     private $propertyAccessor;
  36.     public function __construct(PropertyNameCollectionFactoryInterface $propertyNameCollectionFactory, PropertyMetadataFactoryInterface $propertyMetadataFactory, PropertyAccessorInterface $propertyAccessor = null, ResourceClassResolverInterface $resourceClassResolver = null)
  37.     {
  38.         $this->propertyNameCollectionFactory = $propertyNameCollectionFactory;
  39.         $this->propertyMetadataFactory = $propertyMetadataFactory;
  40.         $this->propertyAccessor = $propertyAccessor ?? PropertyAccess::createPropertyAccessor();
  41.         $this->resourceClassResolver = $resourceClassResolver;
  43.         if (null === $this->resourceClassResolver) {
  44.             @trigger_error(sprintf('Not injecting %s in the IdentifiersExtractor might introduce cache issues with object identifiers.', ResourceClassResolverInterface::class), \E_USER_DEPRECATED);
  45.         }
  46.     }
  48.     /**
  49.      * {@inheritdoc}
  50.      */
  51.     public function getIdentifiersFromResourceClass(string $resourceClass): array
  52.     {
  53.         $identifiers = [];
  54.         foreach ($properties = $this->propertyNameCollectionFactory->create($resourceClass) as $property) {
  55.             if ($this->propertyMetadataFactory->create($resourceClass, $property)->isIdentifier() ?? false) {
  56.                 $identifiers[] = $property;
  57.             }
  58.         }
  60.         if (!$identifiers) {
  61.             if (\in_array('id', iterator_to_array($properties), true)) {
  62.                 return ['id'];
  63.             }
  65.             throw new RuntimeException(sprintf('No identifier defined in "%s". You should add #[\ApiPlatform\Core\Annotation\ApiProperty(identifier: true)]" on the property identifying the resource."', $resourceClass));
  66.         }
  68.         return $identifiers;
  69.     }
  71.     /**
  72.      * {@inheritdoc}
  73.      */
  74.     public function getIdentifiersFromItem($item): array
  75.     {
  76.         $identifiers = [];
  77.         $resourceClass = $this->getResourceClass($item, true);
  78.         $identifierProperties = $this->getIdentifiersFromResourceClass($resourceClass);
  80.         foreach ($this->propertyNameCollectionFactory->create($resourceClass) as $propertyName) {
  81.             if (!\in_array($propertyName, $identifierProperties, true)) {
  82.                 continue;
  83.             }
  85.             $propertyMetadata = $this->propertyMetadataFactory->create($resourceClass, $propertyName);
  86.             $identifier = $identifiers[$propertyName] = $this->propertyAccessor->getValue($item, $propertyName);
  88.             if (!\is_object($identifier)) {
  89.                 continue;
  90.             }
  92.             if (null === $relatedResourceClass = $this->getResourceClass($identifier)) {
  93.                 continue;
  94.             }
  96.             $relatedItem = $identifier;
  97.             unset($identifiers[$propertyName]);
  98.             foreach ($this->propertyNameCollectionFactory->create($relatedResourceClass) as $relatedPropertyName) {
  99.                 $propertyMetadata = $this->propertyMetadataFactory->create($relatedResourceClass, $relatedPropertyName);
  100.                 if ($propertyMetadata->isIdentifier()) {
  101.                     if (isset($identifiers[$propertyName])) {
  102.                         throw new RuntimeException(sprintf('Composite identifiers not supported in "%s" through relation "%s" of "%s" used as identifier', $relatedResourceClass, $propertyName, $resourceClass));
  103.                     }
  105.                     $identifiers[$propertyName] = $this->propertyAccessor->getValue($relatedItem, $relatedPropertyName);
  106.                 }
  107.             }
  109.             if (!isset($identifiers[$propertyName])) {
  110.                 throw new RuntimeException(sprintf('No identifier found in "%s" through relation "%s" of "%s" used as identifier', $relatedResourceClass, $propertyName, $resourceClass));
  111.             }
  112.         }
  114.         return $identifiers;
  115.     }
  116. }