ignoreOtherAttributes = $ignoreOtherAttributes; } public function isSupported(): bool { return \PHP_VERSION_ID >= 80100; } public function build(\Reflector $reflector, Context $context): array { if (!$this->isSupported() || !method_exists($reflector, 'getAttributes')) { return []; } if ($reflector instanceof \ReflectionProperty && method_exists($reflector, 'isPromoted') && $reflector->isPromoted()) { // handled via __construct() parameter return []; } // no proper way to inject Generator::$context = $context; /** @var OA\AbstractAnnotation[] $annotations */ $annotations = []; try { $attributeName = $this->ignoreOtherAttributes ? [OA\AbstractAnnotation::class, \ReflectionAttribute::IS_INSTANCEOF] : []; foreach ($reflector->getAttributes(...$attributeName) as $attribute) { if (class_exists($attribute->getName())) { $instance = $attribute->newInstance(); if ($instance instanceof OA\AbstractAnnotation) { $annotations[] = $instance; } else { if (false === $context->is('other')) { $context->other = []; } $context->other[] = $instance; } } else { $context->logger->debug(sprintf('Could not instantiate attribute "%s"; class not found.', $attribute->getName())); } } if ($reflector instanceof \ReflectionMethod) { // also look at parameter attributes foreach ($reflector->getParameters() as $rp) { foreach ([OA\Property::class, OAT\Parameter::class, OA\RequestBody::class] as $attributeName) { foreach ($rp->getAttributes($attributeName, \ReflectionAttribute::IS_INSTANCEOF) as $attribute) { /** @var OA\Property|OAT\Parameter|OA\RequestBody $instance */ $instance = $attribute->newInstance(); $instance->_context = new Context([ 'nested' => false, 'property' => $rp->getName(), 'reflector' => $rp, ], $context); if ($instance instanceof OA\Property) { if ($rp->isPromoted()) { // ensure each property has its own context $instance->_context = new Context([ 'generated' => true, 'annotations' => [$instance], 'property' => $rp->getName(), 'reflector' => $rp, ], $context); // promoted parameter - docblock is available via class/property if ($comment = $rp->getDeclaringClass()->getProperty($rp->getName())->getDocComment()) { $instance->_context->comment = $comment; } } else { $instance->_context->property = $rp->getName(); } } $annotations[] = $instance; } } } } } finally { Generator::$context = null; } // merge backwards into parents... $isParent = function (OA\AbstractAnnotation $annotation, OA\AbstractAnnotation $possibleParent): bool { // regular annotation hierarchy $explicitParent = null !== $possibleParent->matchNested($annotation) && !$annotation instanceof OA\Attachable; $isParentAllowed = false; // support Attachable subclasses if ($isAttachable = $annotation instanceof OA\Attachable) { if (!$isParentAllowed = (null === $annotation->allowedParents())) { // check for allowed parents foreach ($annotation->allowedParents() as $allowedParent) { if ($possibleParent instanceof $allowedParent) { $isParentAllowed = true; break; } } } } // Attachables can always be nested (unless explicitly restricted) return ($isAttachable && $isParentAllowed) || ($annotation->getRoot() !== $possibleParent->getRoot() && $explicitParent); }; $annotationsWithoutParent = []; foreach ($annotations as $index => $annotation) { $mergedIntoParent = false; for ($ii = 0; $ii < count($annotations); ++$ii) { if ($ii === $index) { continue; } $possibleParent = $annotations[$ii]; if ($isParent($annotation, $possibleParent)) { $mergedIntoParent = true; // $possibleParent->merge([$annotation]); } } if (!$mergedIntoParent) { $annotationsWithoutParent[] = $annotation; } } return $annotationsWithoutParent; } }