v3

Author: fenric

resources/definitions/openapi.php

@@ -42,6 +42,7 @@
     'router.swagger.css_urls' => SwaggerConfiguration::DEFAULT_CSS_URLS,
     'router.swagger.js_urls' => SwaggerConfiguration::DEFAULT_JS_URLS,
     'router.swagger.openapi_uri' => SwaggerConfiguration::DEFAULT_OPENAPI_URI,
+    'router.swagger.template_variables' => [],
 
     OpenApiConfiguration::class => create()
         ->constructor(
@@ -82,5 +83,6 @@
             cssUrls: get('router.swagger.css_urls'),
             jsUrls: get('router.swagger.js_urls'),
             openapiUri: get('router.swagger.openapi_uri'),
+            templateVariables: get('router.swagger.template_variables'),
         ),
 ];

src/OpenApi/Controller/SwaggerController.php

@@ -56,6 +56,7 @@ public function handle(ServerRequestInterface $request): ResponseInterface
             TemplateRenderer::renderTemplate(
                 filename: $this->swaggerConfiguration->templateFilename,
                 variables: [
+                    ...$this->swaggerConfiguration->templateVariables,
                     self::CSS_URLS_VAR_NAME => $this->swaggerConfiguration->cssUrls,
                     self::JS_URLS_VAR_NAME => $this->swaggerConfiguration->jsUrls,
                     self::OPENAPI_URI_VAR_NAME => $this->swaggerConfiguration->openapiUri,

src/OpenApi/SwaggerConfiguration.php

@@ -35,11 +35,13 @@ final class SwaggerConfiguration
 
     public function __construct(
         public readonly string $templateFilename = self::DEFAULT_TEMPLATE_FILENAME,
-        /** @var string[] */
+        /** @var array<array-key, string> */
         public readonly array $cssUrls = self::DEFAULT_CSS_URLS,
-        /** @var string[] */
+        /** @var array<array-key, string> */
         public readonly array $jsUrls = self::DEFAULT_JS_URLS,
         public readonly string $openapiUri = self::DEFAULT_OPENAPI_URI,
+        /** @var array<string, mixed> */
+        public readonly array $templateVariables = [],
     ) {
     }
 }