diff --git a/routing/redirect_in_config.rst b/routing/redirect_in_config.rst
index 89864c4c06c..f9babd3bb44 100644
--- a/routing/redirect_in_config.rst
+++ b/routing/redirect_in_config.rst
@@ -155,3 +155,98 @@ action:
Because you are redirecting to a route instead of a path, the required
option is called ``route`` in the ``redirect()`` action, instead of ``path``
in the ``urlRedirect()`` action.
+
+Keeping the Request Method when Redirecting
+-------------------------------------------
+
+The redirections performed in the previous examples use the ``301`` and ``302``
+HTTP status codes. For legacy reasons, these HTTP redirections change the method
+of ``POST`` requests to ``GET`` (because redirecting a ``POST`` request didn't
+work well in old browsers).
+
+However, in some scenarios it's either expected or required that the redirection
+request uses the same HTTP method. That's why the HTTP standard defines two
+additional status codes (``307`` and ``308``) to perform temporary/permanent
+redirects that maintain the original request method.
+
+The :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\RedirectController::urlRedirectAction`
+and :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\RedirectController::redirectAction`
+methods accept an additional argument called ``keepRequestMethod``. When it's
+set to ``true``, temporary redirects use ``307`` code instead of ``302`` and
+permanent redirects use ``308`` code instead of ``301``::
+
+.. configuration-block::
+
+ .. code-block:: yaml
+
+ # config/routes.yaml
+
+ # redirects with the 308 status code
+ route_foo:
+ # ...
+ controller: Symfony\Bundle\FrameworkBundle\Controller\RedirectController::redirectAction
+ defaults:
+ # ...
+ permanent: true
+ keepRequestMethod: true
+
+ # redirects with the 307 status code
+ route_bar:
+ # ...
+ controller: Symfony\Bundle\FrameworkBundle\Controller\RedirectController::redirectAction
+ defaults:
+ # ...
+ permanent: false
+ keepRequestMethod: true
+
+ .. code-block:: xml
+
+
+
+
+
+
+
+
+ Symfony\Bundle\FrameworkBundle\Controller\RedirectController::urlRedirectAction
+ true
+ true
+
+
+
+
+
+ Symfony\Bundle\FrameworkBundle\Controller\RedirectController::urlRedirectAction
+ false
+ true
+
+
+
+ .. code-block:: php
+
+ // config/routes.php
+ use Symfony\Component\Routing\RouteCollection;
+ use Symfony\Component\Routing\Route;
+
+ $collection = new RouteCollection();
+
+ // redirects with the 308 status code
+ $collection->add('route_foo', new Route('...', array(
+ // ...
+ '_controller' => 'Symfony\Bundle\FrameworkBundle\Controller\RedirectController::urlRedirectAction',
+ 'permanent' => true,
+ 'keepRequestMethod' => true,
+ )));
+
+ // redirects with the 307 status code
+ $collection->add('route_bar', new Route('...', array(
+ // ...
+ '_controller' => 'Symfony\Bundle\FrameworkBundle\Controller\RedirectController::urlRedirectAction',
+ 'permanent' => false,
+ 'keepRequestMethod' => true,
+ )));
+
+ return $collection;
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy