FormData posts and uploads (#151)

* feature: post data with formdata
closes #99

* feature: use phpgt/http Response for FormData posts and uploads
closes #150

* tweak: import CURLFile

composer.json

@@ -10,7 +10,7 @@
 		"ext-json": "*",
 		"phpgt/async": "^1.0",
 		"phpgt/promise": "^2.2.3",
-		"phpgt/http": "^1.2",
+		"phpgt/http": "^1.2.1",
 		"phpgt/curl": "^3.1.1",
 		"phpgt/json": "^1.2",
 		"phpgt/propfunc": "^1.0"

example/05-upload-file.php

@@ -0,0 +1,36 @@
+<?php
+require(implode(DIRECTORY_SEPARATOR, ["..", "vendor", "autoload.php"]));
+
+use Gt\Fetch\Http;
+use Gt\Http\FormData;
+use Gt\Http\Response;
+use Gt\Json\JsonObject;
+
+$formData = new FormData();
+$formData->set("upload", new SplFileObject(__FILE__));
+
+$http = new Http();
+$http->fetch("https://postman-echo.com/post", [
+	"method" => "POST",
+	"headers" => [
+		"Content-type" => "multipart/form-data"
+	],
+	"body" => $formData,
+])
+	->then(function(Response $response) {
+		if(!$response->ok) {
+			throw new RuntimeException("Error uploading file to Postman Echo.");
+		}
+		return $response->json();
+	})
+	->then(function(JsonObject $json) {
+		foreach($json->asArray()["files"] as $fileName => $data) {
+			echo $fileName . " - " . strlen($data) . " bytes", PHP_EOL;
+		}
+	})
+	->catch(function(Throwable $error) {
+		echo "An error occurred: ", $error->getMessage();
+	});
+
+$http->wait();
+die("done waiting");

src/CurlOptBuilder.php

@@ -1,6 +1,9 @@
 <?php
 namespace Gt\Fetch;
 
+use CURLFile;
+use Gt\Http\File;
+use Gt\Http\FormData;
 use Gt\Http\RequestMethod;
 use Psr\Http\Message\RequestInterface;
 use Psr\Http\Message\UriInterface;
@@ -87,7 +90,17 @@ protected function setHeaders(array $headers):void {
 	 * add to your request: this can be a string, associative array
 	 * (representing form data) or binary object.
 	 */
-	protected function setBody(string|array $body):void {
+	protected function setBody(string|array|FormData $body):void {
+		if($body instanceof FormData) {
+			$formData = $body;
+			$body = [];
+			foreach($formData as $key => $value) {
+				if($value instanceof File) {
+					$value = new CURLFile($value->name);
+				}
+				$body[$key] = $value;
+			}
+		}
 		$this->curlOptArray[CURLOPT_POSTFIELDS] = $body;
 	}