Init

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,21 @@
+name: "CodeQL"
+
+on: [ pull_request ]
+jobs:
+  lint:
+    name: CodeQL
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 2
+
+      - run: git checkout HEAD^2
+
+      - name: Install dependencies
+        run: composer install --profile --ignore-platform-reqs 
+
+      - name: Run CodeQL
+        run: composer check

.github/workflows/linter.yml

@@ -0,0 +1,21 @@
+name: "Linter"
+
+on: [ pull_request ]
+jobs:
+  lint:
+    name: Linter
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 2
+
+      - run: git checkout HEAD^2
+
+      - name: Install dependencies
+        run: composer install --profile --ignore-platform-reqs 
+
+      - name: Run Linter
+        run: composer lint

.github/workflows/tests.yml

@@ -0,0 +1,23 @@
+name: "Tests"
+
+on: [ pull_request ]
+jobs:
+  lint:
+    name: Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 2
+
+      - run: git checkout HEAD^2
+
+      - name: Install dependencies
+        run: composer install --profile --ignore-platform-reqs 
+
+      - name: Run Tests
+        run: php -S localhost:8000 tests/router.php &
+          composer test
+

.gitignore

@@ -0,0 +1,3 @@
+vendor
+*.cache
+composer.lock

README.md

@@ -0,0 +1,112 @@
+# Utopia Fetch
+Lite & fast micro PHP library that provides a convenient and flexible way to perform HTTP requests in PHP applications.
+
+# Usage
+The library provides a static method `Client::fetch()` that returns a `Response` object.
+
+The `Client::fetch()` method accepts the following parameters:
+- `url` - A **String** containing the URL to which the request is sent.
+- `method` - A **String** containing the HTTP method for the request. The default method is `GET`.
+- `headers` - An **associative array** of HTTP headers to send.
+- `body` - An **associative array** of data to send as the body of the request.
+- `query` - An **associative array** of query parameters.
+
+The `Response` object has the following methods:
+- `isOk()` - Returns **true** if the response status code is in the range 200-299, **false** otherwise.
+- `getBody()` - Returns the response body as a **String**.
+- `getHeaders()` - Returns an **associative array** of response headers.
+- `getStatusCode()` - Returns the response status code as an **integer**.
+- `getMethod()` - Returns the request method as a **String**.
+- `getUrl()` - Returns the request URL as a **String**.
+- `text()` - Returns the response body as a **String**.
+- `json()` - Returns the response body as an **associative array**.
+- `blob()` - Converts the response body to blob and return it as a **String**.
+
+## Examples
+### GET request
+```php
+<?php
+require_once __DIR__ . '/vendor/autoload.php';
+use Utopia\Fetch\Client;
+
+$url = 'https://httpbin.org/get';
+$method = 'GET';
+$query = [
+  'foo' => 'bar'
+];
+
+$resp = Client::fetch(
+  url: $url,
+  method: $method,
+  query: $query
+);
+
+if($resp->isOk()) { 
+  print("Status Code: " . $resp->getStatusCode() . "\n");
+  print("Response Headers:\n");
+  print_r($resp->getHeaders());
+  print("Response Body:\n");
+  print($resp->getBody());
+}
+else {
+  print("Error: " . $resp->getStatusCode() . "\n");
+  print("Response Headers:\n");
+  print_r($resp->getHeaders());
+  print("Response Body:\n");
+  print($resp->getBody());
+}
+```
+### POST request
+```php
+<?php
+require_once __DIR__ . '/vendor/autoload.php';
+use Utopia\Fetch\Client;
+
+$url = 'https://httpbin.org/post';
+$method = 'POST';
+$headers = [
+  'Content-Type' => 'application/json',
+];
+$body = [
+  'name' => 'John Doe',
+];
+$query = [
+  'foo' => 'bar'
+];
+
+$resp = Client::fetch(
+  url: $url,
+  method: $method,
+  headers: $headers,
+  body: $body,
+  query: $query
+);
+
+print_r($resp->json());
+```
+### Send a file
+```php
+<?php
+require_once __DIR__ . '/vendor/autoload.php';
+use Utopia\Fetch\Client;
+
+$url = 'http://localhost:8000';
+$method = 'POST';
+$headers = [
+  'Content-Type' => 'application/json',
+];
+$filePath = strval(realpath(__DIR__ . '/tests/resources/logo.png')); // Absolute path to the file
+
+$body = [
+    'file' => new \CURLFile($filePath, 'image/png', 'logo.png')
+];
+
+$resp = Client::fetch(
+  url: $url,
+  method: $method,
+  headers: $headers,
+  body: $body
+);
+
+print_r($resp->json());
+```

composer.json

@@ -0,0 +1,26 @@
+{
+    "name": "utopia-php/fetch",
+    "description": "A simple library that provides an interface for making HTTP Requests.",
+    "type": "library",
+    "license": "MIT",
+    "require": {
+        "php": ">=8.0"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^9.5",
+        "laravel/pint": "^1.5.0",
+        "phpstan/phpstan": "^1.10"
+    },
+    "scripts": {
+        "lint": "./vendor/bin/pint --test --config pint.json",
+        "format": "./vendor/bin/pint --config pint.json",
+        "check": "./vendor/bin/phpstan analyse -c phpstan.neon",
+        "test": "./vendor/bin/phpunit --configuration phpunit.xml --debug"
+    },
+    "autoload": {
+        "psr-4": {
+            "Utopia\\Fetch\\": "src/"
+        }
+    },
+    "authors": []
+}

phpstan.neon

@@ -0,0 +1,5 @@
+parameters:
+	level: 8
+	paths:
+		- src
+		- tests

phpunit.xml

@@ -0,0 +1,16 @@
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false"
+        >
+    <testsuites>
+        <testsuite name="Application Test Suite">
+            <directory>./tests/</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>

pint.json

@@ -0,0 +1,3 @@
+{
+  "preset": "psr12"
+}