Documentation about using Command in Controller

... and color coding Ansi output using SensioLabs AnsiToHtml

Author: rvanlaak

cookbook/console/command_in_controller.rst

@@ -0,0 +1,82 @@
+.. index::
+   single: Console; Use commands in your Controller
+
+How to make use of a Command in your application
+===============================
+
+The Console page of the Components section (:doc:`/components/console/introduction`) covers
+how to create a console command. This cookbook article covers how to use a console command
+directly in your application.
+
+Execute Command directly from Controller
+----------------------------------------
+
+Symfony allows you to directly execute a ``Command`` inside your Controller::
+
+    // src/AcmeBundle/Controller/GreetController.php
+    namespace AcmeBundle\Controller;
+
+    use Symfony\Component\Console\Output\StreamOutput;
+    use Symfony\Component\Console\Input\ArrayInput;
+    use Symfony\Bundle\FrameworkBundle\Console\Application;
+
+    class GreetController
+    {
+        public function greetAction($name)
+        {
+            $kernel = $this->get('kernel');
+            $application = new Application($kernel);
+            $application->setAutoExit(false);
+
+            $input = new ArrayInput(array('command' => 'acme:greet'));
+            $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;
+        }
+    }
+
+Color code the Ansi content to HTML
+----------------------------------------
+
+By telling the ``StreamOutput`` it is decorated via the third parameter, it will return the Ansi color-coded content.
+The [SensioLabs AnsiToHtml converter](https://github.com/sensiolabs/ansi-to-html) can be required using ``Composer``
+and helps you to get colorful html::
+
+    // src/AcmeBundle/Controller/GreetController.php
+    namespace AcmeBundle\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
+    {
+        public function greetAction($name)
+        {
+            $kernel = $this->get('kernel');
+            $application = new Application($kernel);
+            $application->setAutoExit(false);
+
+            $input = new ArrayInput(array('command' => 'acme:greet'));
+            $output = new StreamOutput(tmpfile(), StreamOutput::VERBOSITY_NORMAL, true);
+            $application->run($input, $output);
+
+            rewind($output->getStream());
+            $content = stream_get_contents($output->getStream());
+            fclose($output->getStream());
+
+            $converter = new AnsiToHtmlConverter();
+            $content = $converter->convert($content);
+
+            return $content;
+        }
+    }
+
+The ``AnsiToHtmlConverter`` can also be registered
+[as a Twig Extension](https://github.com/sensiolabs/ansi-to-html#twig-integration), and supports optional themes

cookbook/console/index.rst

@@ -6,6 +6,7 @@ Console
 
     console_command
     usage
+    command_in_controller
     sending_emails
     logging
     commands_as_services