Merge branch '5.4' into 6.0

javiereguiluz · javiereguiluz · commit 44fe3b263491 · 2022-10-19T17:35:06.000+02:00
* 5.4:
  [Notifier] Update FreeMobile DSN
  [Serializer] Allow to provide (de)normalization context in mapping
diff --git a/components/serializer.rst b/components/serializer.rst
@@ -229,6 +229,11 @@ normalized data, instead of the denormalizer re-creating them. Note that
 arrays of objects. Those will still be replaced when present in the normalized
 data.
 
+Context
+-------
+
+Many Serializer features can be configured :doc:`using a context </serializer#serializer-context>`.
+
 .. _component-serializer-attributes-groups:
 
 Attributes Groups
diff --git a/notifier.rst b/notifier.rst
@@ -67,7 +67,7 @@ AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_
 Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
 Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
-FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:API_KEY@default?phone=PHONE``
 GatewayApi      ``symfony/gateway-api-notifier``      ``gatewayapi://TOKEN@default?from=FROM``
 Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
diff --git a/serializer.rst b/serializer.rst
@@ -157,6 +157,109 @@ configuration:
             ;
         };
 
+You can also specify the context on a per-property basis::
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Annotation\Context;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+        class Person
+        {
+            /**
+             * @Context({ DateTimeNormalizer::FORMAT_KEY = 'Y-m-d' })
+             */
+            public $createdAt;
+
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Annotation\Context;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+        class Person
+        {
+            #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
+            public $createdAt;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        App\Model\Person:
+            attributes:
+                createdAt:
+                    context:
+                        datetime_format: 'Y-m-d'
+
+    .. code-block:: xml
+
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="createdAt">
+                    <context>
+                        <entry name="datetime_format">Y-m-d</entry>
+                    </context>
+                </attribute>
+            </class>
+        </serializer>
+
+Use the options to specify context specific to normalization or denormalization::
+
+    namespace App\Model;
+
+    use Symfony\Component\Serializer\Annotation\Context;
+    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+    class Person
+    {
+        #[Context(
+            normalizationContext: [DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'],
+            denormalizationContext: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339],
+        )]
+        public $createdAt;
+
+        // ...
+    }
+
+You can also restrict the usage of a context to some groups::
+
+    namespace App\Model;
+
+    use Symfony\Component\Serializer\Annotation\Context;
+    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+    class Person
+    {
+        #[Serializer\Groups(['extended'])]
+        #[Serializer\Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
+        #[Serializer\Context(
+            context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
+            groups: ['extended'],
+        )]
+        public $createdAt;
+
+        // ...
+    }
+
+The attribute/annotation can be repeated as much as needed on a single property.
+Context without group is always applied first. Then context for the matching
+groups are merged in the provided order.
+
 .. _serializer-using-serialization-groups-annotations:
 .. _serializer-using-serialization-groups-attributes:
 
