• Docs
• Source
• Git

<?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\PropertyInfo; use Symfony\Component\PropertyInfo\Util\LegacyTypeConverter; use Symfony\Component\TypeInfo\Type; /** * Default {@see PropertyInfoExtractorInterface} implementation. * * @author Kévin Dunglas <dunglas@gmail.com> * * @final */ class PropertyInfoExtractor implements PropertyInfoExtractorInterface, PropertyInitializableExtractorInterface { /** * @param iterable<mixed, PropertyListExtractorInterface> $listExtractors * @param iterable<mixed, PropertyTypeExtractorInterface> $typeExtractors * @param iterable<mixed, PropertyDescriptionExtractorInterface> $descriptionExtractors * @param iterable<mixed, PropertyAccessExtractorInterface> $accessExtractors * @param iterable<mixed, PropertyInitializableExtractorInterface> $initializableExtractors */ public function __construct( private readonly iterable $listExtractors = [], private readonly iterable $typeExtractors = [], private readonly iterable $descriptionExtractors = [], private readonly iterable $accessExtractors = [], private readonly iterable $initializableExtractors = [], ) { } public function getProperties(string $class, array $context = []): ?array { return $this->extract($this->listExtractors, 'getProperties', [$class, $context]); } public function getShortDescription(string $class, string $property, array $context = []): ?string { return $this->extract($this->descriptionExtractors, 'getShortDescription', [$class, $property, $context]); } public function getLongDescription(string $class, string $property, array $context = []): ?string { return $this->extract($this->descriptionExtractors, 'getLongDescription', [$class, $property, $context]); } public function getType(string $class, string $property, array $context = []): ?Type { foreach ($this->typeExtractors as $extractor) { if (!method_exists($extractor, 'getType')) { $legacyTypes = $extractor->getTypes($class, $property, $context); if (null !== $legacyTypes) { return LegacyTypeConverter::toTypeInfoType($legacyTypes); } continue; } if (null !== $value = $extractor->getType($class, $property, $context)) { return $value; } } return null; } /** * @deprecated since Symfony 7.3, use "getType" instead */ public function getTypes(string $class, string $property, array $context = []): ?array { trigger_deprecation('symfony/property-info', '7.3', 'The "%s()" method is deprecated, use "%s::getType()" instead.', __METHOD__, self::class); return $this->extract($this->typeExtractors, 'getTypes', [$class, $property, $context]); } public function isReadable(string $class, string $property, array $context = []): ?bool { return $this->extract($this->accessExtractors, 'isReadable', [$class, $property, $context]); } public function isWritable(string $class, string $property, array $context = []): ?bool { return $this->extract($this->accessExtractors, 'isWritable', [$class, $property, $context]); } public function isInitializable(string $class, string $property, array $context = []): ?bool { return $this->extract($this->initializableExtractors, 'isInitializable', [$class, $property, $context]); } /** * Iterates over registered extractors and return the first value found. * * @param iterable<mixed, object> $extractors * @param list<mixed> $arguments */ private function extract(iterable $extractors, string $method, array $arguments): mixed { foreach ($extractors as $extractor) { if (null !== $value = $extractor->{$method}(...$arguments)) { return $value; } } return null; } }