[Serializer] Add class/format/context to NameConverterInterface

mttsch · wouterj · commit b53029a64602 · 2024-12-07T13:47:37.000+01:00
Fix #19683
diff --git a/serializer/custom_name_converter.rst b/serializer/custom_name_converter.rst
@@ -30,19 +30,26 @@ A custom name converter can handle such cases::
 
     class OrgPrefixNameConverter implements NameConverterInterface
     {
-        public function normalize(string $propertyName): string
+        public function normalize(string $propertyName, string $class = null, ?string $format = null, array $context = []): string
         {
             // during normalization, add the prefix
             return 'org_'.$propertyName;
         }
 
-        public function denormalize(string $propertyName): string
+        public function denormalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
         {
             // remove the 'org_' prefix on denormalizing
             return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;
         }
     }
 
+.. versionadded:: 7.1
+
+    Accessing the current class name, format and context via
+    :method:`Symfony\\Component\\Serializer\\NameConverter\\NameConverterInterface::normalize`
+    and :method:`Symfony\\Component\\Serializer\\NameConverter\\NameConverterInterface::denormalize`
+    was introduced in Symfony 7.1.
+
 .. note::
 
     You can also implement

Original file line number	Diff line number	Diff line change
`@@ -30,19 +30,26 @@ A custom name converter can handle such cases::`
`30`	`30`
`31`	`31`	`class OrgPrefixNameConverter implements NameConverterInterface`
`32`	`32`	`{`
`33`		`- public function normalize(string $propertyName): string`
	`33`	`+ public function normalize(string $propertyName, string $class = null, ?string $format = null, array $context = []): string`
`34`	`34`	`{`
`35`	`35`	`// during normalization, add the prefix`
`36`	`36`	`return 'org_'.$propertyName;`
`37`	`37`	`}`
`38`	`38`
`39`		`- public function denormalize(string $propertyName): string`
	`39`	`+ public function denormalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string`
`40`	`40`	`{`
`41`	`41`	`// remove the 'org_' prefix on denormalizing`
`42`	`42`	`return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;`
`43`	`43`	`}`
`44`	`44`	`}`
`45`	`45`
	`46`	`+.. versionadded:: 7.1`
	`47`	`+`
	`48`	`+ Accessing the current class name, format and context via`
	`49`	+ :method:`Symfony\\Component\\Serializer\\NameConverter\\NameConverterInterface::normalize`
	`50`	+ and :method:`Symfony\\Component\\Serializer\\NameConverter\\NameConverterInterface::denormalize`
	`51`	`+ was introduced in Symfony 7.1.`
	`52`	`+`
`46`	`53`	`.. note::`
`47`	`54`
`48`	`55`	`You can also implement`