Stars: 216
Forks: 29
Pull Requests: 35
Issues: 31
Watchers: 10
Last Updated: 2023-08-22 21:49:17
An async process dispatcher for Amp.
License: MIT License
Languages: PHP, Makefile
AMPHP is a collection of event-driven libraries for PHP designed with fibers and concurrency in mind.
amphp/process
provides an asynchronous process dispatcher that works on all major platforms (including Windows).
It makes running child processes simple.
As Windows pipes are file handles and do not allow non-blocking access, this package makes use of a process wrapper, that provides access to these pipes via sockets. On Unix-like systems it uses the standard pipes, as these can be accessed without blocking there. Concurrency is managed by the Revolt event loop.
This package can be installed as a Composer dependency.
composer require amphp/process
The package requires PHP 8.1 or later.
Processes are started with Process::start()
:
<?php
require __DIR__ . "/vendor/autoload.php";
use Amp\ByteStream;
use Amp\Process\Process;
// "echo" is a shell internal command on Windows and doesn't work.
$command = DIRECTORY_SEPARATOR === "\\" ? "cmd /c echo Hello World!" : "echo 'Hello, world!'";
$process = Process::start($command);
Amp\async(fn () => Amp\ByteStream\pipe($process->getStdout(), ByteStream\getStdout()));
Amp\async(fn () => Amp\ByteStream\pipe($process->getStderr(), ByteStream\getStderr()));
$exitCode = $process->join();
echo "Process exited with {$exitCode}.\n";
Processes are started with the working directory of the current process by default. The working directory can be customized to another directory if needed:
$process = Amp\Process\Process::start($command, workingDirectory: '/path/of/your/dreams');
Processes are started with the environment variables of the current process by default. The environment can be customized by passing an associative array mapping variables names to their values:
$process = Amp\Process\Process::start($command, environment: [
'PATH' => '/usr/bin/local'
]);
amphp/process
follows the semver semantic versioning specification like all other amphp
packages.
If you discover any security related issues, please use the private security issue reporter instead of using the public issue tracker.
The MIT License (MIT). Please see LICENSE
for more information.