amphp/process

Asynchronous process manager.

Wednesday, July 25, 2018
by amphp
Repository
9 Watchers
54 Stars
101,295 Installations

PHP
13 Dependents
0 Suggesters
8 Forks
4 Open issues
25 Versions
18 % Grown

The README.md

amphp/process

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., _(*1)

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., _(*2)

, _(*3)

Installation

This package can be installed as a Composer dependency., _(*4)

composer require amphp/process

The package requires PHP 8.1 or later., _(*5)

Usage

Processes are started with Process::start():, _(*6)

<?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";

Custom Working Directory

Processes are started with the working directory of the current process by default. The working directory can be customized to another directory if needed:, _(*7)

$process = Amp\Process\Process::start($command, workingDirectory: '/path/of/your/dreams');

Custom Environment Variables

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:, _(*8)

$process = Amp\Process\Process::start($command, environment: [
    'PATH' => '/usr/bin/local'
]);

Versioning

amphp/process follows the semver semantic versioning specification like all other amphp packages., _(*9)

Security

If you discover any security related issues, please use the private security issue reporter instead of using the public issue tracker., _(*10)

License

The MIT License (MIT). Please see LICENSE for more information., _(*11)

The Versions

25/07 2018

dev-ext-async

dev-ext-async https://github.com/amphp/process

Asynchronous process manager.

library process

Asynchronous process manager.

amphp/process

The README.md

amphp/process

Installation

Usage

Custom Working Directory

Custom Environment Variables

Versioning

Security

License

The Versions

dev-ext-async

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

dev-master

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

dev-windows-phar

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

v0.3.3

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

v0.3.2

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

dev-windows-hang

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

dev-windows

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

v0.3.1

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

v0.3.0

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

dev-spawn-close-fds

The Requires

The Development Requires

by Bob Weinand

by Aaron Piotrowski

dev-dave-windows

The Requires

The Development Requires

by Bob Weinand

by Niklas Keller

by Aaron Piotrowski

dev-crash-on-windows-with-parallel

The Requires