Update command_in_controller.rst

with real world example about Swift Mailer.

Author: rvanlaak

cookbook/console/command_in_controller.rst

@@ -1,34 +1,42 @@
 .. index::
    single: Console; Use commands in your Controller
 
-How to make use of a Command in your application
-================================================
+How to Call a Command from a Controller
+=======================================
 
 The :doc:`Console component documentation </components/console/introduction>`_ covers
 how to create a console command. This cookbook article covers how to use a console command
-directly in your application.
+directly in your application. 
 
-Execute Command directly from Controller
-----------------------------------------
+You may have the need to execute some function that is only available in a console command. 
+Usually, you should refactor the command and move some logic into a service that can be 
+reused in the controller. However, when the command is part of a third-party library, you 
+wouldn't want to modify or duplicate their code, but want to directly execute the command 
+instead. 
 
-Symfony allows you to directly execute a ``Command`` inside your Controller::
+An example of this is sending the emails that Swift Mailer spooled earlier
+:doc:`using the ``swiftmailer:spool:send`` command </cookbook/email/spool>`_. Symfony 
+allows you to directly execute a registered ``Command`` inside your Controller::
 
-    // src/AcmeBundle/Controller/GreetController.php
+    // src/AcmeBundle/Controller/SpoolController.php
     namespace AcmeBundle\Controller;
 
     use Symfony\Component\Console\Output\StreamOutput;
     use Symfony\Component\Console\Input\ArrayInput;
     use Symfony\Bundle\FrameworkBundle\Console\Application;
 
-    class GreetController
+    class SpoolController
     {
-        public function greetAction($name)
+        public function sendSpoolAction($messages=10)
         {
             $kernel = $this->get('kernel');
             $application = new Application($kernel);
             $application->setAutoExit(false);
 
-            $input = new ArrayInput(array('command' => 'acme:greet'));
+            $input = new ArrayInput(array(
+               'command' => 'swiftmailer:spool:send',
+               '--message-limit' => $messages,
+            ));
             $output = new StreamOutput(tmpfile(), StreamOutput::VERBOSITY_NORMAL);
             $application->run($input, $output);
 
@@ -40,30 +48,33 @@ Symfony allows you to directly execute a ``Command`` inside your Controller::
         }
     }
 
-Color code the Ansi content to HTML
-----------------------------------------
+Showing Colorized Command Output
+--------------------------------
 
-By telling the ``StreamOutput`` it is decorated via the third parameter, it will return the Ansi color-coded content.
-The `SensioLabs AnsiToHtml converter`_ can be required using ``Composer``
-and helps you to get colorful html::
+By telling the ``StreamOutput`` it is decorated via the third parameter, it will return 
+the Ansi color-coded content. The `SensioLabs AnsiToHtml converter`_ can be required 
+using ``Composer`` and helps you to get colorful html::
 
-    // src/AcmeBundle/Controller/GreetController.php
-    namespace AcmeBundle\Controller;
+    // src/AppBundle/Controller/SpoolController.php
+    namespace AppBundle\Controller;
 
     use Symfony\Component\Console\Output\StreamOutput;
     use Symfony\Component\Console\Input\ArrayInput;
     use Symfony\Bundle\FrameworkBundle\Console\Application;
     use SensioLabs\AnsiConverter\AnsiToHtmlConverter;
 
-    class GreetController
+    class SpoolController
     {
-        public function greetAction($name)
+        public function sendSpoolAction($messages=10)
         {
             $kernel = $this->get('kernel');
             $application = new Application($kernel);
             $application->setAutoExit(false);
 
-            $input = new ArrayInput(array('command' => 'acme:greet'));
+            $input = new ArrayInput(array(
+               'command' => 'swiftmailer:spool:send',
+               '--message-limit' => $messages,
+            ));
             $output = new StreamOutput(tmpfile(), StreamOutput::VERBOSITY_NORMAL, true);
             $application->run($input, $output);
 
@@ -78,8 +89,8 @@ and helps you to get colorful html::
         }
     }
 
-The ``AnsiToHtmlConverter`` can also be registered
-`as a Twig Extension`_, and supports optional themes
+The ``AnsiToHtmlConverter`` can also be registered `as a Twig Extension`_, 
+and supports optional themes.
 
 .. _`SensioLabs AnsiToHtml converter`: https://github.com/sensiolabs/ansi-to-html
 .. _`as a Twig Extension`: https://github.com/sensiolabs/ansi-to-html#twig-integration