paths using the detected @OA\PathItem and @OA\Operation (@OA\Get, etc). */ class BuildPaths { public function __invoke(Analysis $analysis): void { $paths = []; // Merge @OA\PathItems with the same path. if (!Generator::isDefault($analysis->openapi->paths)) { foreach ($analysis->openapi->paths as $annotation) { if (empty($annotation->path)) { $annotation->_context->logger->warning($annotation->identity() . ' is missing required property "path" in ' . $annotation->_context); } elseif (isset($paths[$annotation->path])) { $paths[$annotation->path]->mergeProperties($annotation); $analysis->removeAnnotation($annotation); } else { $paths[$annotation->path] = $annotation; } } } $operations = $analysis->unmerged()->getAnnotationsOfType(OA\Operation::class); // Merge @OA\Operations into existing @OA\PathItems or create a new one. foreach ($operations as $operation) { if ($operation->path) { if (empty($paths[$operation->path])) { $paths[$operation->path] = $pathItem = new OA\PathItem([ 'path' => $operation->path, '_context' => new Context(['generated' => true], $operation->_context), ]); $analysis->addAnnotation($pathItem, $pathItem->_context); } if ($analysis->mergeAnnotations($paths[$operation->path], [$operation])) { $operation->_context->logger->warning('Unable to merge ' . $operation->identity() . ' in ' . $operation->_context); } } } if ($paths) { $analysis->openapi->paths = array_values($paths); } } }