fix: pass configured openapi version to swagger-php (#2159)

ApiDocGenerator.php

@@ -47,6 +47,10 @@ final class ApiDocGenerator
 
     /** @var string[] */
     private $mediaTypes = ['json'];
+    /**
+     * @var ?string
+     */
+    private $openApiVersion = null;
 
     /**
      * @param DescriberInterface[]|iterable      $describers
@@ -70,6 +74,11 @@ public function setMediaTypes(array $mediaTypes)
         $this->mediaTypes = $mediaTypes;
     }
 
+    public function setOpenApiVersion(?string $openApiVersion)
+    {
+        $this->openApiVersion = $openApiVersion;
+    }
+
     public function generate(): OpenApi
     {
         if (null !== $this->openApi) {
@@ -84,6 +93,10 @@ public function generate(): OpenApi
         }
 
         $generator = new Generator($this->logger);
+        if ($this->openApiVersion) {
+            $generator->setVersion($this->openApiVersion);
+        }
+
         // Remove OperationId processor as we use a lot of generated annotations which do not have enough information in their context
         // to generate these ids properly.
         // @see https://github.com/zircote/swagger-php/issues/1153

DependencyInjection/NelmioApiDocExtension.php

@@ -75,6 +75,7 @@ public function load(array $configs, ContainerBuilder $container): void
                 ->addMethodCall('setAlternativeNames', [$nameAliases])
                 ->addMethodCall('setMediaTypes', [$config['media_types']])
                 ->addMethodCall('setLogger', [new Reference('logger')])
+                ->addMethodCall('setOpenApiVersion', [$config['documentation']['openapi'] ?? null])
                 ->addTag('monolog.logger', ['channel' => 'nelmio_api_doc'])
                 ->setArguments([
                     new TaggedIteratorArgument(sprintf('nelmio_api_doc.describer.%s', $area)),