Descripton

This PR fixes an issue where enable_swagger_ui: false did not actually disable the Swagger UI HTML interface.

Currently, when configuring enable_swagger: true and enable_swagger_ui: false, accessing the documentation route (/api/docs), still displays the Swagger UI HTML interface, ignoring the configuration (enable_swagger_ui: false) to disable it.

The goal is to fully disable the Swagger UI HTML interface while keeping the JSON documentation (/api/docs.jsonopenapi) accessible.

Changes

• Modified ApiPlatformExtension to load Swagger UI services (definitions, listeners, providers) only if enable_swagger_ui is true.
• Updated src/Symfony/Action/DocumentationAction.php to throw a NotFoundHttpException when Swagger UI is disabled.

src/Laravel/Controller/DocumentationController::getOpenApiDocumentation() :

if ('html' === $format && $this->swaggerUiEnabled) {
 $operation = $operation->withProcessor('api_platform.swagger_ui.processor')->withWrite(true);
}

src/Symfony/Action/DocumentationAction::getOpenApiDocumentation() :

if ('html' === $format) {
 $operation = $operation->withProcessor('api_platform.swagger_ui.processor')->withWrite(true);
}

• Updated src/Symfony/Action/DocumentationAction.php to check enable_swagger_ui, aligning the logic with src/Laravel/Controller/DocumentationController.php :

- if ('html' === $format) {
+ if ('html' === $format && $this->swaggerUiEnabled) {
 $operation = $operation->withProcessor('api_platform.swagger_ui.processor')->withWrite(true);
}

• Added unit & functional tests (using a custom Kernel to handle dynamic configuration) to cover these scenarios.

Before

api_platform:
 enable_swagger: true
 enable_swagger_ui: false

• /api/docs → still HTML Swagger UI accessible (not expected)
• /api/docs.jsonopenapi → accessible (expected)

After

api_platform:
 enable_swagger: true
 enable_swagger_ui: false

• /api/docs → returns 404
• /api/docs.jsonopenapi → still accessible (expected)