minor #14185 Leave impersonation functions (dFayet)

This PR was merged into the master branch.

Discussion
----------

Leave impersonation functions

Will solve #14183

Documents new Twig functions `impersonation_exit_path` and `impersonation_exit_url` added in symfony/symfony#32841

Commits
-------

b7bd572 Leave impersonation functions

Author: javiereguiluz

reference/twig_reference.rst

@@ -267,6 +267,33 @@ expression
 Creates an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` related
 to the :doc:`ExpressionLanguage component </components/expression_language>`.
 
+impersonation_exit_path
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ impersonation_exit_path(exitTo = null) }}
+
+``exitTo`` *(optional)*
+    **type**: ``string``
+
+Generates a relative URL to exit impersonation. If `exitTo` is specified it will use its value to build the URl,
+elsewhere it will use the current URI.
+If we are not impersonating a user, it will return an empty string.
+
+impersonation_exit_url
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ impersonation_exit_url(exitTo = null) }}
+
+``exitTo`` *(optional)*
+    **type**: ``string``
+
+Equal to the `impersonation_exit_path`_ function, but it'll generate an absolute URL
+instead of a relative one.
+
 Form Related Functions
 ~~~~~~~~~~~~~~~~~~~~~~
 

security/impersonating_user.rst

@@ -94,7 +94,7 @@ instance, to show a link to exit impersonation in a template:
 .. code-block:: html+twig
 
     {% if is_granted('IS_IMPERSONATOR') %}
-        <a href="{{ path('homepage', {'_switch_user': '_exit'}) }}">Exit impersonation</a>
+        <a href="{{ impersonation_exit_path(path('homepage') ) }}">Exit impersonation</a>
     {% endif %}
 
 .. versionadded:: 5.1