Merge pull request symfony#2261 from richardmiller/routing-controller-shortcut

weaverryan · weaverryan · commit 8ecc1f297c3a · 2013-02-24T16:39:13.000-08:00
Adding showing the base controller's urlGenerate method and a related note
diff --git a/book/routing.rst b/book/routing.rst
@@ -1067,13 +1067,13 @@ a route+parameters back to a URL. The
 :method:`Symfony\\Component\\Routing\\Router::generate` methods form this bi-directional
 system. Take the ``blog_show`` example route from earlier::
 
-    $params = $router->match('/blog/my-blog-post');
+    $params = $this->get('router')->match('/blog/my-blog-post');
     // array(
     //     'slug' => 'my-blog-post',
     //     '_controller' => 'AcmeBlogBundle:Blog:show',
     // )
 
-    $uri = $router->generate('blog_show', array('slug' => 'my-blog-post'));
+    $uri = $this->get('router')->generate('blog_show', array('slug' => 'my-blog-post'));
     // /blog/my-blog-post
 
 To generate a URL, you need to specify the name of the route (e.g. ``blog_show``)
@@ -1086,13 +1086,22 @@ that route. With this information, any URL can easily be generated::
         {
             // ...
 
-            $url = $this->get('router')->generate(
+            $url = $this->generateUrl(
                 'blog_show',
                 array('slug' => 'my-blog-post')
             );
         }
     }
 
+.. note::
+
+    In controllers extending from the base
+    :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller`,
+    you can use the
+    :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::generateUrl`
+    method which call's the router service's
+    :method:`Symfony\\Component\\Routing\\Router::generate` method.
+
 In an upcoming section, you'll learn how to generate URLs from inside templates.
 
 .. tip::
