}>|null indexed and sorted by normalized URI template */ private ?array $entries = null; public function __construct( private readonly OpenApiFactoryInterface $openApiFactory, private readonly LoggerInterface $logger, private readonly CacheInterface $cache, ) { } /** * @return list}> sorted by URI template */ public function getAll(): array { return array_values($this->getEntries()); } /** * The given path is normalized (single leading slash, no trailing slash) before comparison. */ public function hasUriTemplate(string $path): bool { return isset($this->getEntries()[$this->normalizeUriTemplate($path)]); } /** * @return array}> */ private function getEntries(): array { if (null !== $this->entries) { return $this->entries; } try { // A throw inside the callback aborts the cache write: a broken document is retried // on the next request instead of being cached until the next cache clear. return $this->entries = $this->cache->get(self::CACHE_KEY, fn (): array => $this->scanEntries()); } catch (Throwable $e) { $this->logger->warning( sprintf('Extra property API endpoint catalog: could not generate the OpenApi document: %s', $e->getMessage()), ['exception' => $e], ); return $this->entries = []; } } /** * @return array}> */ private function scanEntries(): array { $entries = []; $paths = ($this->openApiFactory)()->getPaths()->getPaths(); foreach ($paths as $path => $pathItem) { $methods = []; foreach ([ 'DELETE' => $pathItem->getDelete(), 'GET' => $pathItem->getGet(), 'PATCH' => $pathItem->getPatch(), 'POST' => $pathItem->getPost(), 'PUT' => $pathItem->getPut(), ] as $method => $operation) { if (null !== $operation) { $methods[] = $method; } } if ([] === $methods) { continue; } $uriTemplate = $this->normalizeUriTemplate((string) $path); $entries[$uriTemplate] = ['uriTemplate' => $uriTemplate, 'methods' => $methods]; } ksort($entries, SORT_STRING); return $entries; } /** * Normalizes to a single leading slash and no trailing slash. */ private function normalizeUriTemplate(string $uriTemplate): string { return '/' . trim(trim($uriTemplate), '/'); } }