Documentation Packages Getting Started FAQ Support

Artax ⋅ Parallel Requests

Artax allows making multiple requests in parallel. It leverages non-blocking I/O like all oth er Amp libraries for that. Instead of sending one request, waiting for the response, then doing something different like sending another request, we can use the time we’re usually waiting for the server to respond to send a second request to another (or the same) server.

sequential requests
Sequential Requests
parallel requests
Parallel Requests

As you can see in the sequence diagrams, we save some time there. We only have to wait for the maximum response delay of both requests instead of the sum of both. With more requests this speedup is even more interesting.


$client = new Amp\Artax\DefaultClient;
$promises = [];

foreach ($urls as $url) {
    $promises[$url] = Amp\call(function () use ($client, $url) {
        // "yield" inside a coroutine awaits the resolution of the promise
        // returned from Client::request(). The generator is then continued.
        $response = yield $client->request($url);

        // Same for the body here. Yielding an Amp\ByteStream\Message
        // buffers the entire message.
        $body = yield $response->getBody();

        return $body;

$responses = Amp\Promise\wait(Amp\Promise\all($promises));