Cover of the book Symfony 5: The Fast Track

Symfony 5: The Fast Track is the best book to learn modern Symfony development, from zero to production. +300 pages in full color showing how to combine Symfony with Docker, APIs, queues & async tasks, Webpack, Single-Page Applications, etc.

Buy printed version
WARNING: You are browsing the documentation for Symfony 2.8 which is not maintained anymore. Consider upgrading your projects to Symfony 5.1.

Process Helper

Process Helper

The Process Helper shows processes as they’re running and reports useful information about process status.

To display process details, use the Symfony\Component\Console\Helper\ProcessHelper and run your command with verbosity. For example, running the following code with a very verbose verbosity (e.g. -vv):

use Symfony\Component\Process\ProcessBuilder;

$helper = $this->getHelper('process');
$process = ProcessBuilder::create(array('figlet', 'Symfony'))->getProcess();

$helper->run($output, $process);

will result in this output:


It will result in more detailed output with debug verbosity (e.g. -vvv):


In case the process fails, debugging is easier:



There are three ways to use the process helper:

  • Using a command line string:

    // ...
    $helper->run($output, 'figlet Symfony');
  • An array of arguments:

    // ...
    $helper->run($output, array('figlet', 'Symfony'));


    When running the helper against an array of arguments, be aware that these will be automatically escaped.

  • Passing a Symfony\Component\Process\Process instance:

    use Symfony\Component\Process\ProcessBuilder;
    // ...
    $process = ProcessBuilder::create(array('figlet', 'Symfony'))->getProcess();
    $helper->run($output, $process);

Customized Display

You can display a customized error message using the third argument of the run() method:

$helper->run($output, $process, 'The process failed :(');

A custom process callback can be passed as the fourth argument. Refer to the Process Component for callback documentation:

use Symfony\Component\Process\Process;

$helper->run($output, $process, 'The process failed :(', function ($type, $data) {
    if (Process::ERR === $type) {
        // ... do something with the stderr output
    } else {
        // ... do something with the stdout

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.