parallel.md

title	permalink	description
Parallel Requests	/parallel	Artax allows making multiple requests in parallel. It leverages non-blocking I/O like all other Amp libraries for that.

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.

{:.table-no-border .table-full-width .table-text-center} | 
Sequential 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.

<?php

$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));