Requester

Simple Requester class to wrap guzzle and the retry subscriber

This package requires PHP >=5.4

Installation

Install via composer - edit your composer.json to require the package.

"require": {
    "pulkitjalan/requester": "dev-master"
}

Then run composer update in your terminal to pull it in.

Laravel

There is a Laravel service provider and facade available.

Add the following to the providers array in your config/app.php

'PulkitJalan\Requester\RequesterServiceProvider'

Next add the following to the aliases array in your config/app.php

'Requester' => 'PulkitJalan\Requester\Facades\Requester'

Next run php artisan config:publish pulkitjalan/requester to publish the config file.

Usage

The requester class has a dependency of guzzle and takes in an instance of guzzle as the first param.

Available request methods: get, head, delete, put, patch, post, options

<?php

use PulkitJalan\Requester\Requester;
use GuzzleHttp\Client as GuzzleClient;

$requester = new Requester(new GuzzleClient());

// simple get request
$requester->url('github.com')->get();

Altering the default retry behaviour

// retry 10 times, with a 1 second wait on a 404 error
$requester->url('github.com')->retry(10)->every(1000)->on([404])->get();

// disabling retry
$requester->url('github.com')->retry(false)->get();

Disabling ssl check

// ssl check disabled
$requester->url('github.com')->veify(false)->get();

Use http instead of https

// disable https and use http
$requester->url('github.com')->secure(false)->get();

// use http
$requester->url('http://github.com')->get();

Caching

$response = $requester->url('github.com')->cache(true)->get();

// Same request should return 304 response
$response = $requester->url('github.com')->cache(true)->get();

Create a Post request

// Create a post request
$requester->url('example.com/update/1')->post([
    'body' => [
        'title' => 'some title'
    ]
]);

// Upload a file
$requester->url('example.com/upload')->addFile('/tmp/image.jpg')->post([
    'body' => [
        'title' => 'Some image',
        'description' => 'Some image description'
    ]
]);