[DOCS][Developer] httpclient: Add an example of lazyness care

This commit is contained in:
Diogo Peralta Cordeiro 2021-08-17 20:19:12 +01:00
parent f5918d8d5c
commit fa1585bd00
Signed by: diogo
GPG Key ID: 18D2D35001FBFAB0

View File

@ -8,4 +8,22 @@ The `$options` are elaborated in [Symfony Doc](https://symfony.com/doc/current/h
Please note that the HTTP Client is [lazy](https://en.wikipedia.org/wiki/Lazy_evaluation),
which makes it very important to bear in mind [Network Errors](https://symfony.com/doc/current/http_client.html#dealing-with-network-errors),
An example where this behaviour has to be considered:
```php
if (Common::isValidHttpUrl($url)) {
$head = HTTPClient::head($url);
// This must come before getInfo given that Symfony HTTPClient is lazy (thus forcing curl exec)
try {
$headers = $head->getHeaders();
} catch (ClientException $e) {
throw new InvalidArgumentException(previous: $e);
}
$url = $head->getInfo('url'); // The last effective url (after getHeaders, so it follows redirects)
$url_hash = hash(self::URLHASH_ALGO, $url);
} else {
throw new InvalidArgumentException();
}
```
What you can take from Responses is specified [here](https://symfony.com/doc/current/http_client.html#processing-responses).