mikeevstropov/guzzle

Retrying behavior for Guzzle

mikeevstropov/guzzle

Retrying behavior for Guzzle, _(*1)

Installation

Add dependency mikeevstropov/guzzle, _(*2)

$ composer require mikeevstropov/guzzle

New options

• requests_limit, _(*3)

  Accepts:, _(*4)

  • integer - positive integer

  Default:, _(*5)

  • 1 - only one attempt

  Maximum number of attempts to receive a response., _(*6)

• repeat_on, _(*7)

  Accepts:, _(*8)

  • array - array with a numeric index

  Default:, _(*9)

  • array(0, 5) - repeat failed request or if response code is 5xx

  List of error codes for retrying requests:, _(*10)

  • array(5) - on GuzzleHttp\Exception\ServerException (5xx code)
  • array(4) - on GuzzleHttp\Exception\ClientException (4xx code)
  • array(0) - other TransferException like GuzzleHttp\Exception\ConnectException

  You can combine it like array(4, 5)., _(*11)

Usage

<?php

$client = new \GuzzleHttp\Client();

// Let's try to request "http://httpstat.us/503" that
// page will always return "503 Service Unavailable"
$response = $client->get('http://httpstat.us/503', [
    'requests_limit' => 3,
]); // will thrown GuzzleHttp\Exception\ServerException after 3 attempts

// We can pass option "repeat_on" to prevent retrying
// if response has code 5xx (by default [0, 5])
$response = $client->get('http://httpstat.us/503', [
    'requests_limit' => 3,
    'repeat_on' => array(0, 4)
]); // will thrown GuzzleHttp\Exception\ServerException after first request

// But same options with request to the page that return 4xx
// will have 3 attempts, because we pass "4" as array item in
// option "repeat_on"
$response = $client->get('http://httpstat.us/402', [
    'requests_limit' => 3,
    'repeat_on' => array(0, 4)
]); // will thrown GuzzleHttp\Exception\ServerException after 3 attempts

Development

Clone, _(*12)

$ git clone https://github.com/mikeevstropov/guzzle.git

Go to project, _(*13)

$ cd guzzle

Install dependencies, _(*14)

$ composer install

Increase composer timeout. Since composer by default set it to 300 seconds., _(*15)

$ composer config --global process-timeout 600

Run the tests, _(*16)

$ composer test