Skip to content

Commit 62e78e2

Browse files
committed
[Serializer] update doc for 3.4 about normalizer
1 parent 3c2b8c6 commit 62e78e2

File tree

1 file changed

+8
-38
lines changed

1 file changed

+8
-38
lines changed

serializer/custom_normalizer.rst

Lines changed: 8 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -53,45 +53,15 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
5353
}
5454
}
5555

56-
Registering it in Your Application
57-
----------------------------------
5856

59-
In order to enable the normalizer in an application based on the entire Symfony
60-
framework, you must register it as a service and :doc:`tag it </service_container/tags>`
61-
with ``serializer.normalizer``.
57+
Registering it in your app
58+
--------------------------
6259

63-
.. configuration-block::
60+
If you use the Symfony Framework. then you probably want to register this normalizer
61+
as a service in your app. If you're using the :ref:`default services.yml configuration <service-container-services-load-example>`,
62+
that's done automatically!
6463

65-
.. code-block:: yaml
64+
.. tip::
6665

67-
# app/config/services.yml
68-
services:
69-
app.yaml_encoder:
70-
class: AppBundle\Serializer\TopicNormalizer
71-
tags:
72-
- { name: serializer.normalizer }
73-
74-
.. code-block:: xml
75-
76-
<!-- app/config/services.xml -->
77-
<?xml version="1.0" encoding="UTF-8" ?>
78-
<container xmlns="http://symfony.com/schema/dic/services"
79-
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
80-
xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
81-
82-
<services>
83-
<service id="app.yaml_encoder" class="AppBundle\Serializer\TopicNormalizer">
84-
<tag name="serializer.normalizer" />
85-
</service>
86-
</services>
87-
</container>
88-
89-
.. code-block:: php
90-
91-
// app/config/services.php
92-
use AppBundle\Serializer\TopicNormalizer;
93-
94-
$container
95-
->register('app.yaml_encoder', TopicNormalizer::class)
96-
->addTag('serializer.normalizer')
97-
;
66+
If you're not using autoconfigure, make sure to register your class as a service
67+
and tag it with ``serializer.normalizer``.

0 commit comments

Comments
 (0)