feat: Allows for a user to utilize self-signed certificates (#101)

Author: davcpas1234

lib/Client.php

@@ -197,6 +197,11 @@ class Client
      */
     protected $savedRequests;
 
+    /**
+     * @var bool
+     */
+    protected $verifySSLCerts;
+    
     /**
      * @var bool
      */
@@ -212,27 +217,30 @@ class Client
     /**
      * 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) - this is specific to the SendGrid API
-     * @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
+     * @param string $host           the base url (e.g. https://api.sendgrid.com)
+     * @param array  $headers        global request headers
+     * @param string $version        api version (configurable) - this is specific to the SendGrid API
+     * @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
+     * @param bool   $verifySSLCerts set default verify certificates flag
      */
     public function __construct(
         $host,
         $headers = null,
         $version = null,
         $path = null,
         $curlOptions = null,
-        $retryOnLimit = false
+        $retryOnLimit = false,
+        $verifySSLCerts = true
     ) {
         $this->host = $host;
         $this->headers = $headers ?: [];
         $this->version = $version;
         $this->path = $path ?: [];
         $this->curlOptions = $curlOptions ?: [];
         $this->retryOnLimit = $retryOnLimit;
+        $this->verifySSLCerts = $verifySSLCerts;
         $this->isConcurrentRequest = false;
         $this->savedRequests = [];
     }
@@ -306,7 +314,21 @@ public function setRetryOnLimit($retry)
     }
 
     /**
-     * Set concurrent request flag.
+     * Set default verify certificates flag
+     *
+     * @param bool $verifySSLCerts
+     *
+     * @return Client
+     */
+    public function setVerifySSLCerts($verifySSLCerts)
+    {
+        $this->verifySSLCerts = $verifySSLCerts;
+
+        return $this;
+    }
+
+    /**
+     * Set concurrent request flag
      *
      * @param bool $isConcurrent
      *
@@ -352,7 +374,7 @@ private function createCurlOptions($method, $body = null, $headers = null)
                 CURLOPT_RETURNTRANSFER => true,
                 CURLOPT_HEADER => true,
                 CURLOPT_CUSTOMREQUEST => strtoupper($method),
-                CURLOPT_SSL_VERIFYPEER => true,
+                CURLOPT_SSL_VERIFYPEER => $this->verifySSLCerts,
                 CURLOPT_FAILONERROR => false,
             ] + $this->curlOptions;
 
@@ -572,6 +594,7 @@ public function _($name = null)
         }
         $client = new static($this->host, $this->headers, $this->version, $this->path);
         $client->setCurlOptions($this->curlOptions);
+        $client->setVerifySSLCerts($this->verifySSLCerts);
         $client->setRetryOnLimit($this->retryOnLimit);
         $this->path = [];