welcome back to dyb-tech

2024-05-18 02:28:01 +02:00
parent 9513cdba09
commit 9f30bc98c7
6149 changed files with 668407 additions and 0 deletions
@@ -0,0 +1,103 @@
+<?php
+
+/*
+ * This file is part of the NelmioApiDocBundle package.
+ *
+ * (c) Nelmio
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Nelmio\ApiDocBundle\Render;
+
+use Nelmio\ApiDocBundle\Exception\RenderInvalidArgumentException;
+use OpenApi\Annotations\OpenApi;
+use OpenApi\Annotations\Server;
+use OpenApi\Context;
+use OpenApi\Generator;
+use Psr\Container\ContainerInterface;
+use Symfony\Component\HttpFoundation\Request;
+
+class RenderOpenApi
+{
+    public const HTML = 'html';
+    public const JSON = 'json';
+    public const YAML = 'yaml';
+
+    /** @var ContainerInterface */
+    private $generatorLocator;
+
+    /** @var array<string, OpenApiRenderer|null> */
+    private $openApiRenderers = [];
+
+    public function __construct(ContainerInterface $generatorLocator, ?OpenApiRenderer ...$openApiRenderers)
+    {
+        $this->generatorLocator = $generatorLocator;
+        foreach ($openApiRenderers as $openApiRenderer) {
+            if (null === $openApiRenderer) {
+                continue;
+            }
+
+            $this->openApiRenderers[$openApiRenderer->getFormat()] = $openApiRenderer;
+        }
+    }
+
+    public function getAvailableFormats(): array
+    {
+        return array_keys($this->openApiRenderers);
+    }
+
+    public function renderFromRequest(Request $request, string $format, $area, array $extraOptions = [])
+    {
+        $options = [];
+        if ('' !== $request->getBaseUrl()) {
+            $options += [
+                'fallback_url' => $request->getSchemeAndHttpHost().$request->getBaseUrl(),
+            ];
+        }
+        $options += $extraOptions;
+
+        return $this->render($format, $area, $options);
+    }
+
+    /**
+     * @throws InvalidArgumentException If the area to dump is not valid
+     */
+    public function render(string $format, string $area, array $options = []): string
+    {
+        if (!$this->generatorLocator->has($area)) {
+            throw new RenderInvalidArgumentException(sprintf('Area "%s" is not supported.', $area));
+        } elseif (!array_key_exists($format, $this->openApiRenderers)) {
+            throw new RenderInvalidArgumentException(sprintf('Format "%s" is not supported.', $format));
+        }
+
+        /** @var OpenApi $spec */
+        $spec = $this->generatorLocator->get($area)->generate();
+        $tmpServers = $spec->servers;
+        try {
+            $spec->servers = $this->getServersFromOptions($spec, $options);
+
+            return $this->openApiRenderers[$format]->render($spec, $options);
+        } finally {
+            $spec->servers = $tmpServers; // Restore original value as we should not modify OpenApi object from the generator
+        }
+    }
+
+    private function getServersFromOptions(OpenApi $spec, array $options)
+    {
+        if (array_key_exists('server_url', $options) && $options['server_url']) {
+            return [new Server(['url' => $options['server_url'], '_context' => new Context()])];
+        }
+
+        if (Generator::UNDEFINED !== $spec->servers) {
+            return $spec->servers;
+        }
+
+        if (array_key_exists('fallback_url', $options) && $options['fallback_url']) {
+            return [new Server(['url' => $options['fallback_url'], '_context' => new Context()])];
+        }
+
+        return Generator::UNDEFINED;
+    }
+}