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 ` 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 `. 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`
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy