Fixed URI identifier parameter mismatch in SwaggerUI Links section

Author: maxtorete

src/Swagger/Serializer/DocumentationNormalizer.php

@@ -799,8 +799,11 @@ private function getLinkObject(string $resourceClass, string $operationId, strin
         if (!$linkObject) {
             return [];
         }
+        preg_match_all('/{(.*)}/', $path, $uriParams);
+        $identifierUriParam = !empty($uriParams[1]) ? end($uriParams[1]) : 'id';
+
         $linkObject['operationId'] = $operationId;
-        $linkObject['description'] = 1 === \count($identifiers) ? sprintf('The `%1$s` value returned in the response can be used as the `id` parameter in `GET %2$s`.', $identifiers[0], $path) : sprintf('The values returned in the response can be used in `GET %s`.', $path);
+        $linkObject['description'] = 1 === \count($identifiers) ? sprintf('The `%1$s` value returned in the response can be used as the `%2$s` parameter in `GET %3$s`.', $identifiers[0], $identifierUriParam, $path) : sprintf('The values returned in the response can be used in `GET %s`.', $path);
 
         return $linkObject;
     }

tests/Metadata/Property/Factory/SerializerPropertyMetadataFactoryTest.php

@@ -83,6 +83,9 @@ public function testCreate($readGroups, $writeGroups)
         $dummySerializerClassMetadata->addAttributeMetadata($relatedDummySerializerAttributeMetadata);
         $nameConvertedSerializerAttributeMetadata = new SerializerAttributeMetadata('nameConverted');
         $dummySerializerClassMetadata->addAttributeMetadata($nameConvertedSerializerAttributeMetadata);
+        $nameSerializedSerializerAttributeMetadata = new SerializerAttributeMetadata('nameSerialized');
+        $nameSerializedSerializerAttributeMetadata->setSerializedName('name_serialized');
+        $dummySerializerClassMetadata->addAttributeMetadata($nameSerializedSerializerAttributeMetadata);
         $serializerClassMetadataFactoryProphecy->getMetadataFor(Dummy::class)->willReturn($dummySerializerClassMetadata);
         $relatedDummySerializerClassMetadata = new SerializerClassMetadata(RelatedDummy::class);
         $idSerializerAttributeMetadata = new SerializerAttributeMetadata('id');
@@ -105,6 +108,9 @@ public function testCreate($readGroups, $writeGroups)
         $nameConvertedPropertyMetadata = (new PropertyMetadata())
             ->withType(new Type(Type::BUILTIN_TYPE_STRING, true));
         $decoratedProphecy->create(Dummy::class, 'nameConverted', [])->willReturn($nameConvertedPropertyMetadata);
+        $nameSerializedPropertyMetadata = (new PropertyMetadata())
+            ->withType(new Type(Type::BUILTIN_TYPE_STRING, true));
+        $decoratedProphecy->create(Dummy::class, 'nameSerialized', [])->willReturn($nameSerializedPropertyMetadata);
 
         $resourceClassResolverProphecy = $this->prophesize(ResourceClassResolverInterface::class);
         $resourceClassResolverProphecy->isResourceClass(RelatedDummy::class)->willReturn(true);
@@ -116,6 +122,7 @@ public function testCreate($readGroups, $writeGroups)
         $actual[] = $serializerPropertyMetadataFactory->create(Dummy::class, 'foo');
         $actual[] = $serializerPropertyMetadataFactory->create(Dummy::class, 'relatedDummy');
         $actual[] = $serializerPropertyMetadataFactory->create(Dummy::class, 'nameConverted');
+        $actual[] = $serializerPropertyMetadataFactory->create(Dummy::class, 'nameSerialized');
 
         $this->assertInstanceOf(PropertyMetadata::class, $actual[0]);
         $this->assertFalse($actual[0]->isReadable());
@@ -130,6 +137,9 @@ public function testCreate($readGroups, $writeGroups)
         $this->assertInstanceOf(PropertyMetadata::class, $actual[2]);
         $this->assertFalse($actual[2]->isReadable());
         $this->assertFalse($actual[2]->isWritable());
+
+        $this->assertInstanceOf(PropertyMetadata::class, $actual[3]);
+        $this->assertEquals($actual[3]->getSerializedName(), 'name_serialized');
     }
 
     public function groupsProvider(): array