,bool> */ private array $isRepeatableAttribute = []; /** * @psalm-return class-string-map> * * @template T of Annotation */ public function getClassAnnotations(ReflectionClass $class): array { return $this->convertToAttributeInstances($class->getAttributes()); } /** * @return class-string-map> * * @template T of Annotation */ public function getMethodAnnotations(ReflectionMethod $method): array { return $this->convertToAttributeInstances($method->getAttributes()); } /** * @return class-string-map> * * @template T of Annotation */ public function getPropertyAnnotations(ReflectionProperty $property): array { return $this->convertToAttributeInstances($property->getAttributes()); } /** * @param class-string $annotationName The name of the annotation. * * @return T|null * * @template T of Annotation */ public function getPropertyAnnotation(ReflectionProperty $property, $annotationName) { if ($this->isRepeatable($annotationName)) { throw new LogicException(sprintf( 'The attribute "%s" is repeatable. Call getPropertyAnnotationCollection() instead.', $annotationName )); } return $this->getPropertyAnnotations($property)[$annotationName] ?? ($this->isRepeatable($annotationName) ? new RepeatableAttributeCollection() : null); } /** * @param class-string $annotationName The name of the annotation. * * @return RepeatableAttributeCollection * * @template T of Annotation */ public function getPropertyAnnotationCollection( ReflectionProperty $property, string $annotationName ): RepeatableAttributeCollection { if (! $this->isRepeatable($annotationName)) { throw new LogicException(sprintf( 'The attribute "%s" is not repeatable. Call getPropertyAnnotation() instead.', $annotationName )); } return $this->getPropertyAnnotations($property)[$annotationName] ?? new RepeatableAttributeCollection(); } /** * @param array $attributes * * @return class-string-map> * * @template T of Annotation */ private function convertToAttributeInstances(array $attributes): array { $instances = []; foreach ($attributes as $attribute) { $attributeName = $attribute->getName(); assert(is_string($attributeName)); // Make sure we only get Doctrine Annotations if (! is_subclass_of($attributeName, Annotation::class)) { continue; } $instance = $attribute->newInstance(); assert($instance instanceof Annotation); if ($this->isRepeatable($attributeName)) { if (! isset($instances[$attributeName])) { $instances[$attributeName] = new RepeatableAttributeCollection(); } $collection = $instances[$attributeName]; assert($collection instanceof RepeatableAttributeCollection); $collection[] = $instance; } else { $instances[$attributeName] = $instance; } } return $instances; } /** * @param class-string $attributeClassName */ private function isRepeatable(string $attributeClassName): bool { if (isset($this->isRepeatableAttribute[$attributeClassName])) { return $this->isRepeatableAttribute[$attributeClassName]; } $reflectionClass = new ReflectionClass($attributeClassName); $attribute = $reflectionClass->getAttributes()[0]->newInstance(); return $this->isRepeatableAttribute[$attributeClassName] = ($attribute->flags & Attribute::IS_REPEATABLE) > 0; } }