denismitr/net-call

Easy to use and mockable HTTP client, wraps most common http calls functionality around Guzzle.

NetCall

NetCall is a convenient and easy to use HTTP client. It is a wrapper around Guzzle, made for most common use cases. And is designed to make development and testing easier and more pleasant., _(*1)

Author

Denis Mitrofanov, _(*2)

Installation

composer require denismitr/net-call

Usage

$response = NetCall::new()->get('http://www.google.com?foo=bar');

// NetCallResponseInterface methods
$response->body(); // : string
$response->json(); // : array
$response->header('some-key');
$response->headers(); // : array
$response->status(); // : int
$response->isSuccess(); // : bool
$response->isOk(); // : bool
$response->isRedirect(); // : bool
$response->isServerError(); // : bool

```php // request params will be json encoded by default $response = NetCall::new()->post('http://test.com/post', [ 'foo' => 'bar', 'baz' => 'qux', ]);, <sub>(*3)</sub>

$response->json(); // array with json response data, <sub>(*4)</sub>

From Params
```php
$response = NetCall::new()->asFormData()->post('http://myurl.com/post', [
    'foo' => 'bar',
    'baz' => 'qux',
]);

Multipart, <sub>(*5)</sub>

$response = NetCall::new()->asMultipart()->post('http://myurl.com/multi-part', [
    [
        'name' => 'foo',
        'contents' => 'bar'
    ],
    [
        'name' => 'baz',
        'contents' => 'qux',
    ],
    [
        'name' => 'test-file',
        'contents' => 'test contents',
        'filename' => 'test-file.txt',
    ],
]);

With Headers, <sub>(*6)</sub>

$response = NetCall::new()
    ->withHeaders(['Custom' => 'Header'])
    ->get('http://myurl.com/get');

Set Accept header, <sub>(*7)</sub>

$response = NetCall::new()
    ->accept('application/json')
    ->post('http://myurl.com/post');

Patch requests are supported, <sub>(*8)</sub>

$response = NetCall::new()->patch('http://myurl.com/patch', [
    'foo' => 'bar',
    'baz' => 'qux',
]);

Exceptions

Exceptions are not thrown on 4xx and 5xx: use response status method instead., <sub>(*9)</sub>

Redirects

Redirects are followed by default, <sub>(*10)</sub>

To disable that:, <sub>(*11)</sub>

$response = NetCall::new()->noRedirects()->get('http://myurl.com/get');

$response->status(); // 302
$response->header('Location'); // http://myurl.com/redirected

Auth

Basic auth, <sub>(*12)</sub>

$response = NetCall::new()
    ->withBasicAuth('username', 'password')
    ->get('http://myurl.com/basic-auth');

Digest auth, <sub>(*13)</sub>

$response = NetCall::new()
    ->withDigestAuth('username', 'password')
    ->get('http://myurl.com/digest-auth');

Timeout

Set timeout, <sub>(*14)</sub>

NetCall::new()->timeout(1)->get('http://myurl.com/timeout');

// If more then a second passes
// \Denismitr\NetCall\Exceptions\NetCallException is thrown