minor symfony#9186 add Prefixing the Names of Imported Routes (ismail1432, javiereguiluz)

javiereguiluz · javiereguiluz · commit bcb407616e02 · 2018-02-07T09:18:20.000+01:00
This PR was merged into the 3.4 branch. Discussion ---------- add Prefixing the Names of Imported Routes This PR follows this one symfony#9159 Commits ------- f8b8e0d Some fixes and rewords 5ec506d add Prefixing the Names of Imported Routes
diff --git a/routing/external_resources.rst b/routing/external_resources.rst
@@ -133,6 +133,41 @@ suppose you want to prefix all routes in the AppBundle with ``/site`` (e.g.
 The path of each route being loaded from the new routing resource will now
 be prefixed with the string ``/site``.
 
+Prefixing the Names of Imported Routes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 3.4
+    The feature to prefix route names was introduced in Symfony 3.4.
+
+You also have the possibility to prefix all route names defined in a controller
+class with the ``name`` attribute of the ``@Route`` annotation::
+
+    use Symfony\Component\Routing\Annotation\Route;
+
+    /**
+     * @Route(name="blog_")
+     */
+    class BlogController extends Controller
+    {
+        /**
+         * @Route("/blog", name="index")
+         */
+        public function indexAction()
+        {
+            // ...
+        }
+
+        /**
+         * @Route("/blog/posts/{slug}", name="post")
+         */
+        public function showAction(Post $post)
+        {
+            // ...
+        }
+    }
+
+In this example, the names of the routes will be ``blog_index`` and ``blog_post``.
+
 Adding a Host Requirement to Imported Routes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
