Adding precision on how to define attributes on the root node for the…

… XML Encoder
symfony · OskarStark · Nov 29, 2023 · Nov 28, 2023 · Nov 29, 2023 · c09286e4296fed52cb7b49b3317825edcd53fef7
commit c09286e4296fed52cb7b49b3317825edcd53fef7
diff --git a/components/serializer.rst b/components/serializer.rst
@@ -1162,6 +1162,23 @@ the key  ``#comment`` can be used for encoding XML comments::
 You can pass the context key ``as_collection`` in order to have the results
 always as a collection.

+.. note::
+
+    You may need to add some attributes on the root node::
+
+        $encoder = new XmlEncoder();
+        $encoder->encode([
+            '@attribute1' => 'foo',
+            '@attribute2' => 'bar',
+            '#' => ['foo' => ['@bar' => 'value', '#' => 'baz']]
+        ], 'xml');
+
+        // will return:
+        // <?xml version="1.0"?>
+        // <response attribute1="foo" attribute2="bar">
+        // <foo bar="value">baz</foo>
+        // </response>
+
 .. tip::

    XML comments are ignored by default when decoding contents, but this