Added save() method to print received content to a file.

Author: muhammetsafak

README.md

@@ -311,6 +311,30 @@ cURL starts and executes.
 public function handler(): bool
 ```
 
+### `save()`
+
+After cURL is handled, it writes the content to the specified file.
+
+```php
+public function save(string $filePath): false|int
+```
+
+Returns the number of bytes written on success.
+
+**Example :**
+
+```php
+/** @var \InitPHP\Curl\Curl $curl */
+$curl = new \InitPHP\Curl\Curl();
+$curl->setUrl("http://example.com")
+        ->prepare()
+        ->handler();
+        
+if($curl->save(__DIR__ . '/example.html') === FALSE){
+    echo "The file could not be written.";
+}
+```
+
 ## Credits
 
 - [Muhammet ŞAFAK](https://www.muhammetsafak.com.tr) <<[email protected]>>

src/Curl.php

@@ -70,6 +70,9 @@ class Curl
     /** @var null|resource|false */
     protected $curl = null;
 
+    /** @var null|bool|string */
+    protected $exec = null;
+
     public function __construct()
     {
         if(!\extension_loaded('curl')){
@@ -241,6 +244,19 @@ public function getError(): ?string
         return empty($this->error) ? null : $this->error;
     }
 
+    /**
+     * @param string $filePath
+     * @return false|int
+     */
+    public function save(string $filePath)
+    {
+        $content = $this->getResponse('body');
+        if (empty($content)) {
+            return false;
+        }
+        return @\file_put_contents($filePath, $content);
+    }
+
     /**
      * @param int|string $key
      * @param mixed $value
@@ -271,7 +287,7 @@ public function handler(): bool
             if(!empty($this->options)){
                 \curl_setopt_array($this->curl, $this->options);
             }
-            $res = \curl_exec($this->curl);
+            $this->exec = \curl_exec($this->curl);
             $this->getInfo = \curl_getinfo($this->curl);
             $this->error = \curl_error($this->curl);
         }catch (\Exception $e) {
@@ -285,20 +301,20 @@ public function handler(): bool
             ]);
             \curl_reset($this->curl);
             \curl_close($this->curl);
+            $this->curl = null;
         }
-        return $res !== FALSE;
+        return !empty($this->exec);
     }
 
-
     private function curlOptionsPrepare(): void
     {
         if(\defined('CURLOPT_PROTOCOLS')){
             $this->addCurlOption(\CURLOPT_PROTOCOLS, (\CURLPROTO_HTTP | \CURLPROTO_HTTPS))
                 ->addCurlOption(\CURLOPT_REDIR_PROTOCOLS, (\CURLPROTO_HTTP | \CURLPROTO_HTTPS));
         }
         $this->addCurlOption(\CURLOPT_HEADER, false)
-            ->addCurlOption(\CURLOPT_RETURNTRANSFER, false)
             ->addCurlOption(\CURLOPT_FAILONERROR, false);
+        $this->addCurlOption(\CURLOPT_RETURNTRANSFER, false);
 
         $canFollow = $this->canFollow && $this->allowRedirects;
         $this->addCurlOption(\CURLOPT_FOLLOWLOCATION, $canFollow)