Julio Montoya fd4f13f5e0 Adding zendframework/zend-config + updating vendors see BT#8703 10 years ago
..
Exception dfd21a5ed6 Updating vendors 10 years ago
Pipes fd4f13f5e0 Adding zendframework/zend-config + updating vendors see BT#8703 10 years ago
Tests fd4f13f5e0 Adding zendframework/zend-config + updating vendors see BT#8703 10 years ago
.gitignore e542aa471d Updating vendors 10 years ago
CHANGELOG.md dfd21a5ed6 Updating vendors 10 years ago
ExecutableFinder.php 9c33ca0b2a Updating vendors. 10 years ago
LICENSE dfd21a5ed6 Updating vendors 10 years ago
PhpExecutableFinder.php 9c33ca0b2a Updating vendors. 10 years ago
PhpProcess.php fd4f13f5e0 Adding zendframework/zend-config + updating vendors see BT#8703 10 years ago
Process.php fd4f13f5e0 Adding zendframework/zend-config + updating vendors see BT#8703 10 years ago
ProcessBuilder.php 9c33ca0b2a Updating vendors. 10 years ago
ProcessUtils.php fd4f13f5e0 Adding zendframework/zend-config + updating vendors see BT#8703 10 years ago
README.md d48116686f Adding emojis, adding markdown see BT#8764 10 years ago
composer.json fd4f13f5e0 Adding zendframework/zend-config + updating vendors see BT#8703 10 years ago
phpunit.xml.dist 9c33ca0b2a Updating vendors. 10 years ago

README.md

Process Component

Process executes commands in sub-processes.

In this example, we run a simple directory listing and get the result back:

use Symfony\Component\Process\Process;

$process = new Process('ls -lsa');
$process->setTimeout(3600);
$process->run();
if (!$process->isSuccessful()) {
    throw new RuntimeException($process->getErrorOutput());
}

print $process->getOutput();

You can think that this is easy to achieve with plain PHP but it's not especially if you want to take care of the subtle differences between the different platforms.

And if you want to be able to get some feedback in real-time, just pass an anonymous function to the run() method and you will get the output buffer as it becomes available:

use Symfony\Component\Process\Process;

$process = new Process('ls -lsa');
$process->run(function ($type, $buffer) {
    if (Process::ERR === $type) {
        echo 'ERR > '.$buffer;
    } else {
        echo 'OUT > '.$buffer;
    }
});

That's great if you want to execute a long running command (like rsync-ing files to a remote server) and give feedback to the user in real-time.

Resources

You can run the unit tests with the following command:

$ cd path/to/Symfony/Component/Process/
$ composer.phar install
$ phpunit