Merge branch '4.4'

* 4.4:
  Added a versionadded directive
  [DX] Improving redirect config

Author: javiereguiluz

routing.rst

@@ -1309,8 +1309,7 @@ the ``template`` option:
 Redirecting to URLs and Routes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use the ``RedirectController`` to redirect to other routes (``redirectAction``)
-and URLs (``urlRedirectAction``):
+Use the ``RedirectController`` to redirect to other routes and URLs:
 
 .. configuration-block::
 
@@ -1319,7 +1318,7 @@ and URLs (``urlRedirectAction``):
         # config/routes.yaml
         doc_shortcut:
             path: /doc
-            controller: Symfony\Bundle\FrameworkBundle\Controller\RedirectController::redirectAction
+            controller: Symfony\Bundle\FrameworkBundle\Controller\RedirectController
             defaults:
                 route: 'doc_page'
                 # optionally you can define some arguments passed to the route
@@ -1336,7 +1335,7 @@ and URLs (``urlRedirectAction``):
 
         legacy_doc:
             path: /legacy/doc
-            controller: Symfony\Bundle\FrameworkBundle\Controller\RedirectController::urlRedirectAction
+            controller: Symfony\Bundle\FrameworkBundle\Controller\RedirectController
             defaults:
                 # this value can be an absolute path or an absolute URL
                 path: 'https://legacy.example.com/doc'
@@ -1352,7 +1351,7 @@ and URLs (``urlRedirectAction``):
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
             <route id="doc_shortcut" path="/doc"
-                   controller="Symfony\Bundle\FrameworkBundle\Controller\RedirectController::redirectAction">
+                   controller="Symfony\Bundle\FrameworkBundle\Controller\RedirectController">
                 <default key="route">doc_page</default>
                 <!-- optionally you can define some arguments passed to the route -->
                 <default key="page">index</default>
@@ -1368,7 +1367,7 @@ and URLs (``urlRedirectAction``):
             </route>
 
             <route id="legacy_doc" path="/legacy/doc"
-                   controller="Symfony\Bundle\FrameworkBundle\Controller\RedirectController::urlRedirectAction">
+                   controller="Symfony\Bundle\FrameworkBundle\Controller\RedirectController">
                 <!-- this value can be an absolute path or an absolute URL -->
                 <default key="path">https://legacy.example.com/doc</default>
                 <!-- redirections are temporary by default (code 302) but you can make them permanent (code 301)-->
@@ -1385,7 +1384,7 @@ and URLs (``urlRedirectAction``):
 
         return function (RoutingConfigurator $routes) {
             $routes->add('doc_shortcut', '/doc')
-                ->controller([RedirectController::class, 'redirectAction'])
+                ->controller(RedirectController::class)
                  ->defaults([
                     'route' => 'doc_page',
                     // optionally you can define some arguments passed to the template
@@ -1403,7 +1402,7 @@ and URLs (``urlRedirectAction``):
             ;
 
             $routes->add('legacy_doc', '/legacy/doc')
-                ->controller([RedirectController::class, 'urlRedirectAction'])
+                ->controller(RedirectController::class)
                  ->defaults([
                     // this value can be an absolute path or an absolute URL
                     'path' => 'https://legacy.example.com/doc',
@@ -1418,6 +1417,13 @@ and URLs (``urlRedirectAction``):
     Symfony also provides some utilities to
     :ref:`redirect inside controllers <controller-redirect>`
 
+.. versionadded:: 4.4
+
+    In Symfony versions prior to 4.4, you needed to define the specific
+    ``RedirectController`` method to use (either ``redirectAction`` or
+    ``urlRedirectAction``). Starting from Symfony 4.4 this is no longer needed
+    because Symfony detects if the redirection is to a route or an URL.
+
 .. _routing-trailing-slash-redirection:
 
 Redirecting URLs with Trailing Slashes