Add default flag, Make default to false

Author: budirec

examples/example.php

@@ -18,6 +18,15 @@
 echo $response->body();
 echo $response->headers();
 
+// GET with auto retry on rate limit
+$query_params = ['limit' => 100, 'offset' => 0];
+$request_headers = ['X-Mock: 200'];
+$retryOnLimit = true;
+$response = $client->api_keys()->get(null, $query_params, $request_headers, $retryOnLimit);
+echo $response->statusCode();
+echo $response->body();
+echo $response->headers();
+
 // POST
 $request_body = [
     'name' => 'My PHP API Key',

lib/Client.php

@@ -32,17 +32,20 @@ class Client
     protected $curlOptions;
     /** @var array */
     private $methods;
+    /** @var bool */
+    private $retryOnLimit;
 
     /**
       * Initialize the client
       *
-      * @param string $host        the base url (e.g. https://api.sendgrid.com)
-      * @param array  $headers     global request headers
-      * @param string $version     api version (configurable)
-      * @param array  $path        holds the segments of the url path
-      * @param array  $curlOptions extra options to set during curl initialization
+      * @param string  $host          the base url (e.g. https://api.sendgrid.com)
+      * @param array   $headers       global request headers
+      * @param string  $version       api version (configurable)
+      * @param array   $path          holds the segments of the url path
+      * @param array   $curlOptions   extra options to set during curl initialization
+      * @param bool    $retryOnLimit  set default retry on limit flag
       */
-    public function __construct($host, $headers = null, $version = null, $path = null, $curlOptions = null)
+    public function __construct($host, $headers = null, $version = null, $path = null, $curlOptions = null, $retryOnLimit = false)
     {
         $this->host = $host;
         $this->headers = $headers ?: [];
@@ -51,6 +54,8 @@ public function __construct($host, $headers = null, $version = null, $path = nul
         $this->curlOptions = $curlOptions ?: [];
         // These are the supported HTTP verbs
         $this->methods = ['delete', 'get', 'patch', 'post', 'put'];
+
+        $this->retryOnLimit = $retryOnLimit;
     }
 
     /**
@@ -138,7 +143,7 @@ private function buildUrl($queryParams = null)
       *
       * @return Response object
       */
-    public function makeRequest($method, $url, $body = null, $headers = null, $retryOnLimit = true)
+    public function makeRequest($method, $url, $body = null, $headers = null, $retryOnLimit = false)
     {
         $curl = curl_init($url);
 
@@ -221,7 +226,8 @@ public function __call($name, $args)
             $queryParams = isset($args[1]) ? $args[1] : null;
             $url = $this->buildUrl($queryParams);
             $headers = isset($args[2]) ? $args[2] : null;
-            return $this->makeRequest($name, $url, $body, $headers);
+            $retryOnLimit = isset($args[3]) ? $args[3] : $this->retryOnLimit;
+            return $this->makeRequest($name, $url, $body, $headers, $retryOnLimit);
         }
 
         return $this->_($name);