README

A lightweight concurrency manager for PHP, supporting Fiber-based parallel execution out of the box. Optionally, you can use RoadRunner jobs-based parallelism (WIP).

Installation

composer require beauty-framework/parallels

Quick Start

use Beauty\Parallels\Concurrent;
use Beauty\Parallels\WorkersName;

$results = Concurrent::run([
    'task-1' => fn() => 1 + 1,
    'task-2' => fn() => strtoupper('hello'),
]);

print_r($results);

Output:

[
    'task-1' => 2,
    'task-2' => 'HELLO',
]

Execution Modes

Concurrent::run(array $callbacks, int $timeoutSeconds = 10, string $type = WorkersName::FIBER): array

Available modes:

You can explicitly choose the execution strategy:

Concurrent::run([
    'a' => fn() => 42,
], 5, WorkersName::FIBER);

Notes

• Fiber-based mode is enabled by default, lightweight and fast.
• RoadRunner-based process execution is under active development and is experimental.

TODO

• Finish implementation of ProcessConcurrencyWorker based on spiral/roadrunner-jobs
• Add serialization-safe closures via opis/closure
• Result collector with Redis or temp files
• Per-task exception handling and cancellation support
• Tests

License

MIT