1.7 KiB
| layout | title | permalink |
|---|---|---|
| docs | Introduction | / |
Amp is a set of seamlessly integrated concurrency libraries for PHP based on Revolt. This package provides futures and cancellations as a base for asynchronous programming.
Amp makes heavy use of fibers shipped with PHP 8.1 to write asynchronous code just like synchronous, blocking code. In
contrast to earlier versions, there's no need for generator based coroutines or callbacks. Similar to threads, each
fiber has its own call stack, but fibers are scheduled cooperatively by the event loop. Use Amp\async() to run things
concurrently.
Installation
This package can be installed as a Composer dependency.
composer require amphp/amp
If you use this library, it's very likely you want to schedule events using Revolt's event loop, which you should require separately, even if it's automatically installed as a dependency.
composer require revolt/event-loop
Preamble
The weak link when managing concurrency is humans; we simply don't think asynchronously or in parallel. Instead, we're very good at doing one thing at a time and the world around us generally fits this model. So to effectively design for concurrent processing in our code we have a couple of options:
- Get smarter (not feasible);
- Abstract concurrent task execution to make it feel synchronous.
Contents
Amp provides futures and cancellations as building blocks for (partially and fully) asynchronous libraries and applications. Coroutines make asynchronous code feel as synchronous code.