resolveAllOfRefs($analysis); $this->resolveFQCNRefs($analysis); $this->removeDuplicateRefs($analysis); } /** * Update refs broken due to allOf augmenting. */ protected function resolveAllOfRefs(Analysis $analysis): void { $schemas = $analysis->getAnnotationsOfType(OA\Schema::class); // ref rewriting $updatedRefs = []; foreach ($schemas as $schema) { if (!Generator::isDefault($schema->allOf)) { // do we have to keep track of property refs that need updating? foreach ($schema->allOf as $ii => $allOfSchema) { if (!Generator::isDefault($allOfSchema->properties)) { $updatedRefs[OA\Components::ref($schema->schema . '/properties', false)] = OA\Components::ref($schema->schema . '/allOf/' . $ii . '/properties', false); break; } } } } if ($updatedRefs) { foreach ($analysis->annotations as $annotation) { if (property_exists($annotation, 'ref') && !Generator::isDefault($annotation->ref) && $annotation->ref !== null) { foreach ($updatedRefs as $origRef => $updatedRef) { if (str_starts_with((string) $annotation->ref, $origRef)) { $annotation->ref = str_replace($origRef, $updatedRef, (string) $annotation->ref); } } } } } } protected function resolveFQCNRefs(Analysis $analysis): void { $annotations = $analysis->getAnnotationsOfType(OA\Components::componentTypes()); foreach ($annotations as $annotation) { if (property_exists($annotation, 'ref') && !Generator::isDefault($annotation->ref) && is_string($annotation->ref) && !$this->isRef($annotation->ref)) { // check if we can resolve the ref to a component $resolved = false; foreach (OA\Components::componentTypes() as $type) { if ($refSchema = $analysis->getAnnotationForSource($annotation->ref, $type)) { $resolved = true; $annotation->ref = OA\Components::ref($refSchema); } } if (!$resolved && ($refAnnotation = $analysis->getAnnotationForSource($annotation->ref, $annotation::class))) { $annotation->ref = OA\Components::ref($refAnnotation); } } } } protected function removeDuplicateRefs(Analysis $analysis): void { $schemas = $analysis->getAnnotationsOfType(OA\Schema::class); foreach ($schemas as $schema) { if (!Generator::isDefault($schema->allOf)) { $refs = []; $dupes = []; foreach ($schema->allOf as $ii => $allOfSchema) { if (!Generator::isDefault($allOfSchema->ref)) { if (in_array($allOfSchema->ref, $refs)) { $dupes[] = $allOfSchema->ref; $analysis->removeAnnotation($allOfSchema); unset($schema->allOf[$ii]); continue; } $refs[] = $allOfSchema->ref; } } if ($dupes) { $schema->allOf = array_values($schema->allOf); } } } } }