README

Diciotto is a no-nonsense PSR-18 compliant HTTP client library for PHP 7.

Principles

Documentation should be unnecessary
Provide sensible defaults
Explicit is better than implicit
Prefer a good Developer eXperience over performance
No surprises

Install

    composer require fain182/diciotto

How to...

make a GET request

    $httpClient = new HttpClient();
    $response = $httpClient->sendRequest( new Request('http://www.google.com') );

make a POST request with body in JSON

    $httpClient = new HttpClient();
    $request = new JsonRequest('https://httpbin.org/put', 'POST', ['name' => 'value']);
    $response = $httpClient->sendRequest($request);

make a request with a different timeout

The default timeout is 15 seconds.

    $httpClient = (new HttpClient())->withTimeout(30);
    $response = $httpClient->sendRequest( new Request('http://www.google.com') );

make a request to a server with self-signed or invalid SSL certificate

    $httpClient = (new HttpClient())->withCheckSslCertificates(false);
    $response = $httpClient->sendRequest( new Request('http://www.google.com') );

make a request with a cookie

    $httpClient = new HttpClient();
    $request = (new Request('http://www.google.com'))->withAddedCookie('name', 'value');
    $response = $httpClient->sendRequest( $request );

Diciotto raise exception if the request is invalid (RequestException), or if there are network problems (NetworkException). Response with status code 4xx or 5xx are treated the same way as the others, so no exception or error is raised.