Add an example to the invokable controllers section

javiereguiluz · OskarStark · commit 6259e80cec59 · 2019-04-02T13:19:17.000+02:00
diff --git a/controller/service.rst b/controller/service.rst
@@ -78,9 +78,24 @@ syntax:
 Invokable Controllers
 ---------------------
 
-If your controller implements the ``__invoke()`` method - popular with the
-Action-Domain-Response (ADR) pattern, you can simply refer to the service id
-(``AppBundle\Controller\HelloController`` or ``app.hello_controller`` for example).
+Controllers can also define a single action using the ``__invoke()`` method,
+which is a common practice when following the `ADR pattern`_
+(Action-Domain-Responder)::
+
+    // src/AppBundle/Controller/Hello.php
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
+
+    /**
+     * @Route("/hello/{name}", name="hello")
+     */
+    class Hello
+    {
+        public function __invoke($name = 'World')
+        {
+            return new Response(sprintf('Hello %s!', $name));
+        }
+    }
 
 Alternatives to base Controller Methods
 ---------------------------------------
@@ -139,3 +154,4 @@ If you want to know what type-hints to use for each service, see the
 .. _`base Controller class`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/ControllerTrait.php
 .. _`ControllerTrait`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/ControllerTrait.php
 .. _`AbstractController`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php
+.. _`ADR pattern`: https://en.wikipedia.org/wiki/Action%E2%80%93domain%E2%80%93responder
