From 1f7acabadb279da41096137e567fd41ec3dd31de Mon Sep 17 00:00:00 2001
From: Richard <rvanlaak@gmail.com>
Date: Fri, 6 Mar 2015 12:12:56 +0100
Subject: [PATCH] Documentation about using Command in Controller

... and color coding Ansi output using SensioLabs AnsiToHtml

Documentation about using Command in Controller

... and color coding Ansi output using SensioLabs AnsiToHtml

Line syntax

Change component link

Update command_in_controller.rst

with real world example about Swift Mailer.

Update command_in_controller.rst

Added command_in_controller to map.rst.inc

Update map.rst.inc

Documentation about using Command in Controller

Update command_in_controller.rst

Documentation about using Command in Controller

Documentation about using Command in Controller

Update command_in_controller.rst

Update command_in_controller.rst

Documentation about using Command in Controller
---
 cookbook/console/command_in_controller.rst | 86 ++++++++++++++++++++++
 cookbook/console/index.rst                 |  1 +
 cookbook/map.rst.inc                       |  1 +
 3 files changed, 88 insertions(+)
 create mode 100644 cookbook/console/command_in_controller.rst

diff --git a/cookbook/console/command_in_controller.rst b/cookbook/console/command_in_controller.rst
new file mode 100644
index 00000000000..1d77288acd7
--- /dev/null
+++ b/cookbook/console/command_in_controller.rst
@@ -0,0 +1,86 @@
+.. index::
+   single: Console; How to Call a Command from a controller
+
+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 from your 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.
+
+.. caution::
+
+    In comparison with a direct call from the console, calling a command from a controller
+    has a slight performance impact because of the request stack overhead. This way of
+    calling a command is only useful for small tasks.
+
+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/AppBundle/Controller/SpoolController.php
+    namespace AppBundle\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Console\Application;
+    use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+    use Symfony\Component\Console\Input\ArrayInput;
+    use Symfony\Component\Console\Output\StreamOutput;
+
+    class SpoolController extends Controller
+    {
+        public function sendSpoolAction($messages = 10)
+        {
+            $kernel = $this->get('kernel');
+            $application = new Application($kernel);
+            $application->setAutoExit(false);
+
+            $input = new ArrayInput(array(
+               'command' => 'swiftmailer:spool:send',
+               '--message-limit' => $messages,
+            ));
+            $output = new StreamOutput(tmpfile(), StreamOutput::VERBOSITY_NORMAL);
+            $application->run($input, $output);
+
+            rewind($output->getStream());
+            $content = stream_get_contents($output->getStream());
+            fclose($output->getStream());
+
+            return $content;
+        }
+    }
+
+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 getting colorful HTML::
+
+    // src/AppBundle/Controller/SpoolController.php
+    namespace AppBundle\Controller;
+
+    use SensioLabs\AnsiConverter\AnsiToHtmlConverter;
+    // ...
+
+    class SpoolController extends Controller
+    {
+        public function sendSpoolAction($messages = 10)
+        {
+            // ...
+
+            $converter = new AnsiToHtmlConverter();
+            return $converter->convert($content);
+        }
+    }
+
+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
diff --git a/cookbook/console/index.rst b/cookbook/console/index.rst
index 6f1f939d772..c3628beb4f7 100644
--- a/cookbook/console/index.rst
+++ b/cookbook/console/index.rst
@@ -6,6 +6,7 @@ Console
 
     console_command
     usage
+    command_in_controller
     sending_emails
     logging
     commands_as_services
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
index a6213c2dd6f..d26b43a7367 100644
--- a/cookbook/map.rst.inc
+++ b/cookbook/map.rst.inc
@@ -42,6 +42,7 @@
 
   * :doc:`/cookbook/console/console_command`
   * :doc:`/cookbook/console/usage`
+  * :doc:`/cookbook/console/command_in_controller`
   * :doc:`/cookbook/console/sending_emails`
   * :doc:`/cookbook/console/logging`
   * :doc:`/cookbook/console/commands_as_services`