This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
symfony/src/Symfony/Component/Process
Tugdual Saunier 0f4d8af6cf [Process][Tests] fixed chainedCommandsOutput tests
for OS where echo does not support -n option (like MacOS X)
2012-11-19 21:53:52 +01:00
..
Exception [Process] Fixed ProcessFailedException not populating exception message due to a missing sprintf parameter 2012-04-25 15:42:54 +01:00
Tests [Process][Tests] fixed chainedCommandsOutput tests 2012-11-19 21:53:52 +01:00
.gitattributes Fix export-ignore on Windows 2012-11-08 10:51:48 +01:00
CHANGELOG.md [Process] added CHANGELOG 2012-04-26 21:35:39 +02:00
composer.json Add minimum-stability (dev) in each component 2012-08-22 15:48:41 +02:00
ExecutableFinder.php [Process] Clean-up/simplify code 2012-07-03 18:58:27 +02:00
LICENSE Updated LICENSE files copyright 2012-02-22 10:10:37 +01:00
PhpExecutableFinder.php [Process] Add default xampp path to the list of possible paths to check 2012-07-03 18:58:37 +02:00
PhpProcess.php [Process] changed ExecutableFinder to return false instead of throwing an exception when the executable is not found 2011-04-26 15:18:24 +02:00
phpunit.xml.dist [Components] Tests/Autoloading fixes 2012-05-01 17:51:41 +02:00
Process.php Nsdocblocks 2012-10-20 09:10:30 +02:00
ProcessBuilder.php [Process] remade ProcessBuilder::setTimeout fluent 2012-07-11 14:45:17 +02:00
README.md [Components] Tests/Autoloading fixes 2012-05-01 17:51:41 +02:00

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 ('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:

phpunit