Implement removeHeader(); unsetHeader now unsets existing header

removeHeader() removes an internal request header.
unsetHeader() now removes an extra header previously set using setHeader().

Author: zachborboa

README.md

@@ -202,6 +202,7 @@ Curl::patch($url, $data = array())
 Curl::post($url, $data = array(), $follow_303_with_post = false)
 Curl::progress($callback)
 Curl::put($url, $data = array())
+Curl::removeHeader($key)
 Curl::search($url, $data = array())
 Curl::setBasicAuthentication($username, $password = '')
 Curl::setConnectTimeout($seconds)
@@ -249,6 +250,7 @@ MultiCurl::close()
 MultiCurl::complete($callback)
 MultiCurl::error($callback)
 MultiCurl::getOpt($option)
+MultiCurl::removeHeader($key)
 MultiCurl::setBasicAuthentication($username, $password = '')
 MultiCurl::setConcurrency($concurrency)
 MultiCurl::setConnectTimeout($seconds)

src/Curl/Curl.php

@@ -495,7 +495,7 @@ public function options($url, $data = array())
             $url = $this->baseUrl;
         }
         $this->setURL($url, $data);
-        $this->unsetHeader('Content-Length');
+        $this->removeHeader('Content-Length');
         $this->setOpt(CURLOPT_CUSTOMREQUEST, 'OPTIONS');
         return $this->exec();
     }
@@ -517,7 +517,7 @@ public function patch($url, $data = array())
         }
 
         if (is_array($data) && empty($data)) {
-            $this->unsetHeader('Content-Length');
+            $this->removeHeader('Content-Length');
         }
 
         $this->setURL($url);
@@ -900,6 +900,8 @@ public function setDefaultUserAgent()
     /**
      * Set Header
      *
+     * Add extra header to include in the request.
+     *
      * @access public
      * @param  $key
      * @param  $value
@@ -1058,15 +1060,30 @@ public function success($callback)
     /**
      * Unset Header
      *
+     * Remove extra header previously set using Curl::setHeader().
+     *
      * @access public
      * @param  $key
      */
     public function unsetHeader($key)
     {
-        $this->setHeader($key, '');
         unset($this->headers[$key]);
     }
 
+    /**
+     * Remove Header
+     *
+     * Remove an internal header from the request.
+     * Using `curl -H "Host:" ...' is equivalent to $curl->removeHeader('Host');.
+     *
+     * @access public
+     * @param  $key
+     */
+    public function removeHeader($key)
+    {
+        $this->setHeader($key, '');
+    }
+
     /**
      * Verbose
      *

src/Curl/MultiCurl.php

@@ -159,7 +159,7 @@ public function addOptions($url, $data = array())
         }
         $curl = new Curl();
         $curl->setURL($url, $data);
-        $curl->unsetHeader('Content-Length');
+        $curl->removeHeader('Content-Length');
         $curl->setOpt(CURLOPT_CUSTOMREQUEST, 'OPTIONS');
         $this->queueHandle($curl);
         return $curl;
@@ -182,7 +182,7 @@ public function addPatch($url, $data = array())
         }
         $curl = new Curl();
         $curl->setURL($url);
-        $curl->unsetHeader('Content-Length');
+        $curl->removeHeader('Content-Length');
         $curl->setOpt(CURLOPT_CUSTOMREQUEST, 'PATCH');
         $curl->setOpt(CURLOPT_POSTFIELDS, $data);
         $this->queueHandle($curl);
@@ -212,7 +212,7 @@ public function addPost($url, $data = array(), $follow_303_with_post = false)
         $curl = new Curl();
 
         if (is_array($data) && empty($data)) {
-            $curl->unsetHeader('Content-Length');
+            $curl->removeHeader('Content-Length');
         }
 
         $curl->setURL($url);
@@ -643,15 +643,30 @@ public function success($callback)
     /**
      * Unset Header
      *
+     * Remove extra header previously set using Curl::setHeader().
+     *
      * @access public
      * @param  $key
      */
     public function unsetHeader($key)
     {
-        $this->setHeader($key, '');
         unset($this->headers[$key]);
     }
 
+    /**
+     * Remove Header
+     *
+     * Remove an internal header from the request.
+     * Using `curl -H "Host:" ...' is equivalent to $curl->removeHeader('Host');.
+     *
+     * @access public
+     * @param  $key
+     */
+    public function removeHeader($key)
+    {
+        $this->setHeader($key, '');
+    }
+
     /**
      * Verbose
      *