openapi_context parameters do not appear

[allphat]

API Platform version(s) affected: 2.6.0

Description
since v2.6.0 my parameters do not appear in the interface

How to reproduce
If i declare an apiResource in my entity like that:
@ApiResource(

• normalizationContext={"groups"={"get"}},
  

• collectionOperations={
  

•     "senders"={
  

•         "method"="GET",
  

•         "path"="/senders/{type}/{media}",
  

•         "controller"=GetSenders::class,
  

•         "pagination_enabled"=false,
  

•         "openapi_context"={
  

•             "summary"="Get senders by type and media",
  

•             "parameters"={
  

•                 {
  

•                      "description"="Type of sender",
  

•                      "name"="type",
  

•                      "in"="path",
  

•                      "type"="string",
  

•                      "required"=true,
  

•                      "default"="BOTH"
  

•                 },
  

•                 {
  

•                     "description"="Type of medium",
  

•                     "name"="media",
  

•                     "in"="path",
  

•                     "type"="string",
  

•                     "required"=true,
  

•                     "default"="EMAIL"
  

•                 }
  

•             }
  

•         }
  

•     }
  

• },
  

• itemOperations={"get"}
  

the 2 parameters appear if I use v2.5.9 but disappear in 2.6.x

Is there something i have to change to make it work?

[brianvanderwerf1982]

Confirmed, after the upgrade of v2.5.9 to v2.6.1 the config of openapi_context stopped working around parameters.
Other things like tags, summary, requestBody, etc still works.
And I didnt see anything within the changelog that could explain this behaviour.

[Cbruyere]

Regarding the OpenApiFactory :

            $pathItem = $pathItem->{'with'.ucfirst($method)}(new Model\Operation(
                $operationId,
                $operation['openapi_context']['tags'] ?? (OperationType::SUBRESOURCE === $operationType ? $operation['shortNames'] : [$resourceShortName]),
                $responses,
                $operation['openapi_context']['summary'] ?? $this->getPathDescription($resourceShortName, $method, $operationType),
                $operation['openapi_context']['description'] ?? $this->getPathDescription($resourceShortName, $method, $operationType),
                isset($operation['openapi_context']['externalDocs']) ? new ExternalDocumentation($operation['openapi_context']['externalDocs']['description'] ?? null, $operation['openapi_context']['externalDocs']['url']) : null,
                $parameters,
                $requestBody,
                isset($operation['openapi_context']['callbacks']) ? new \ArrayObject($operation['openapi_context']['callbacks']) : null,
                $operation['openapi_context']['deprecated'] ?? (bool) $resourceMetadata->getTypedOperationAttribute($operationType, $operationName, 'deprecation_reason', false, true),
                $operation['openapi_context']['security'] ?? null,
                $operation['openapi_context']['servers'] ?? null

that's normally not in line with the OpenApi spec's 3.0 ? because "parameters" key sould be in openapi_context for path items
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md#pathsObject

or maybe now we have to use extensions properties ?
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md#specificationExtensions

EDIT :
setting extensionProperties in OpenApiFactory doesn't work :

$this->docs->withExtensionProperty('value', 'Custom x-value value');
$ext = $this->docs->getExtensionProperties();
# $ext = {array} [0]

[soyuka]

Thank you for reporting this issue. As this wasn't tested on our earlier Swagger component I forgot to add it. See #4001 for the patch.

[Cbruyere]

great, could you fix also the extensionProperties ? thanks for the job.

[soyuka]

I think that it's working:

$docs = $docs->withExtensionProperty('value', 'Custom x-value value');
dump($docs);