[PropertyAccess] Allow to escape dots and squared brackets in property paths

Author: alexandre-daubois

components/property_access.rst

@@ -81,6 +81,20 @@ You can also use multi dimensional arrays::
     var_dump($propertyAccessor->getValue($persons, '[0][first_name]')); // 'Wouter'
     var_dump($propertyAccessor->getValue($persons, '[1][first_name]')); // 'Ryan'
 
+.. tip::
+
+    If the key of the array contains a dot ``.``, a left squared bracket ``[``
+    or a right squared bracket ``]``, it is possible to escape these characters
+    with a backslash. In the above example, if the array key becomes ``first.name``,
+    accessing the value can be achieved like this::
+
+        var_dump($propertyAccessor->getValue($persons, '[0][first\.name]')); // 'Wouter'
+        var_dump($propertyAccessor->getValue($persons, '[1][first\.name]')); // 'Ryan'
+
+.. versionadded:: 6.3
+
+    Escaping dots and squared brackets in a property path was introduced in Symfony 6.3.
+
 Reading from Objects
 --------------------