fix(swagger): disable Swagger UI and keep openapi.json

Author: Maxcastel

src/Symfony/Action/DocumentationAction.php

@@ -28,6 +28,7 @@
 use Negotiation\Negotiator;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 
 /**
  * Generates the API documentation.
@@ -48,6 +49,7 @@ public function __construct(
         private readonly ?ProcessorInterface $processor = null,
         ?Negotiator $negotiator = null,
         private readonly array $documentationFormats = [OpenApiNormalizer::JSON_FORMAT => ['application/vnd.openapi+json'], OpenApiNormalizer::FORMAT => ['application/json']],
+        private readonly bool $swaggerUiEnabled = true,
     ) {
         $this->negotiator = $negotiator ?? new Negotiator();
     }
@@ -83,6 +85,10 @@ public function __invoke(?Request $request = null)
      */
     private function getOpenApiDocumentation(array $context, string $format, Request $request): OpenApi|Response
     {
+        if ('html' === $format && !$this->swaggerUiEnabled) {
+            throw new NotFoundHttpException('Swagger UI is disabled.');
+        }
+
         if ($this->provider && $this->processor) {
             $context['request'] = $request;
             $operation = new Get(
@@ -93,7 +99,7 @@ class: OpenApi::class,
                 outputFormats: $this->documentationFormats
             );
 
-            if ('html' === $format) {
+            if ('html' === $format && $this->swaggerUiEnabled) {
                 $operation = $operation->withProcessor('api_platform.swagger_ui.processor')->withWrite(true);
             }
 

src/Symfony/Bundle/DependencyInjection/ApiPlatformExtension.php

@@ -586,13 +586,13 @@ private function registerSwaggerConfiguration(ContainerBuilder $container, array
             $loader->load('openapi/yaml.php');
         }
 
-        $loader->load('swagger_ui.php');
+        if ($config['enable_swagger_ui']) {
+            $loader->load('swagger_ui.php');
 
-        if ($config['use_symfony_listeners']) {
-            $loader->load('symfony/swagger_ui.php');
-        }
+            if ($config['use_symfony_listeners']) {
+                $loader->load('symfony/swagger_ui.php');
+            }
 
-        if ($config['enable_swagger_ui']) {
             $loader->load('state/swagger_ui.php');
         }
 

src/Symfony/Bundle/Resources/config/symfony/controller.php

@@ -47,5 +47,6 @@
             service('api_platform.state_processor.main'),
             service('api_platform.negotiator')->nullOnInvalid(),
             '%api_platform.docs_formats%',
+            '%api_platform.enable_swagger_ui%',
         ]);
 };