Added MinIO Storage adapter

src/Storage/Device/MinIO.php

@@ -0,0 +1,119 @@
+<?php
+
+namespace Utopia\Storage\Device;
+
+use Utopia\Storage\Device\S3;
+
+class MinIO extends S3
+{
+    /**
+     * Regions constants
+     *
+     */
+    const EU_CENTRAL_1='eu-central-1';
+    const US_SOUTHEAST_1='us-southeast-1';
+    const US_EAST_1='us-east-1';
+    const AP_SOUTH_1='ap-south-1';
+
+    /**
+     * Object Storage Constructor
+     *
+     * @param string $root
+     * @param string $accessKey
+     * @param string $secretKey
+     * @param string $protocol
+     * @param string $host
+     * @param string $bucket
+     * @param string $region
+     * @param string $acl
+     */
+    public function __construct(string $root, string $accessKey, string $secretKey, string $protocol, string $host, string $bucket, string $region = self::EU_CENTRAL_1, string $acl = self::ACL_PRIVATE)
+    {
+        parent::__construct($root, $accessKey, $secretKey, $bucket, $region, $acl);
+
+        $this->protocol = $protocol;
+        $this->headers['host'] = $host;
+    }
+
+    /**
+     * Get list of objects in the given path.
+     *
+     * @param string $path
+     * 
+     * @throws \Exception
+     *
+     * @return array
+     */
+    public function listObjects($prefix = '', $maxKeys = 1000, $continuationToken = '')
+    {
+        $uri = '/' . $this->getRoot();
+        $this->headers['content-type'] = 'text/plain';
+        $this->headers['content-md5'] = \base64_encode(md5('', true));
+
+        $parameters = [
+            'list-type' => 2,
+            'prefix' => $prefix,
+            'max-keys' => $maxKeys,
+        ];
+        if(!empty($continuationToken)) {
+            $parameters['continuation-token'] = $continuationToken;
+        }
+        $response = parent::call(self::METHOD_GET, $uri, '', $parameters);
+        return $response->body;
+    }
+
+    /**
+     * Delete files in given path, path must be a directory. Return true on success and false on failure.
+     *
+     * @param string $path
+     * 
+     * @throws \Exception
+     *
+     * @return bool
+     */
+    public function deletePath(string $path): bool
+    {
+        $uri = '/' . $this->getRoot();
+        $continuationToken = '';
+        do {
+            $objects = $this->listObjects($path, continuationToken: $continuationToken);
+            $count = (int) ($objects['KeyCount'] ?? 1);
+            if($count < 1) {
+                break;
+            }
+            $continuationToken = $objects['NextContinuationToken'] ?? '';
+            $body = '<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">';
+
+            if($count > 1) {
+                foreach ($objects['Contents'] as $object) {
+                    $body .= "<Object><Key>{$object['Key']}</Key></Object>";
+                }
+            } else {
+                $body .= "<Object><Key>{$objects['Contents']['Key']}</Key></Object>"; 
+            }
+            $body .= '<Quiet>true</Quiet>';
+            $body .= '</Delete>';
+            $this->amzHeaders['x-amz-content-sha256'] = \hash('sha256', $body);
+            $this->headers['content-md5'] = \base64_encode(md5($body, true));
+            parent::call(self::METHOD_POST, $uri, $body, ['delete'=>'']);
+        } while(!empty($continuationToken));
+
+        return true;
+    }
+
+    /**
+     * @return string
+     */
+    public function getName(): string
+    {
+        return 'MinIO Object Storage';
+    }
+
+    /**
+     * @return string
+     */
+    public function getDescription(): string
+    {
+        return 'MinIO Object Storage';
+    }
+}

src/Storage/Device/S3.php

@@ -116,6 +116,7 @@ public function __construct(string $root, string $accessKey, string $secretKey,
         $this->acl = $acl;
         $this->headers['host'] = $this->bucket . '.s3.'.$this->region.'.amazonaws.com';
         $this->amzHeaders = [];
+        $this->protocol = 'https';
     }
 
     /**
@@ -659,9 +660,9 @@ private function getSignatureV4(string $method, string $uri, array $parameters =
      *
      * @return  object
      */
-    private function call(string $method, string $uri, string $data = '', array $parameters=[])
+    public function call(string $method, string $uri, string $data = '', array $parameters=[])
     {
-        $url = 'https://' . $this->headers['host'] . $uri . '?' . \http_build_query($parameters, '', '&', PHP_QUERY_RFC3986);
+        $url = $this->protocol . '://' . $this->headers['host'] . $uri . '?' . \http_build_query($parameters, '', '&', PHP_QUERY_RFC3986);
         $response = new \stdClass;
         $response->body = '';
         $response->headers = [];

src/Storage/Storage.php

@@ -16,6 +16,7 @@ class Storage
     const DEVICE_WASABI = 'Wasabi';
     const DEVICE_BACKBLAZE = 'Backblaze';
     const DEVICE_LINODE= 'Linode';
+    const DEVICE_MINIO= 'MinIO';
 
     /**
      * Devices.

tests/Storage/Device/MinIOTest.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Utopia\Tests;
+
+use Utopia\Storage\Device\MinIO;
+use Utopia\Tests\S3Base;
+
+class MinIOTest extends S3Base
+{
+    protected function init(): void
+    {
+        $this->root = 'minio-test-bucket';
+        $key = $_SERVER['MINIO_ACCESS_KEY'] ?? '';
+        $secret = $_SERVER['MINIO_SECRET'] ?? '';
+        $protocol = $_SERVER['MINIO_PROTOCOL'] ?? '';
+        $host = $_SERVER['MINIO_HOST'] ?? '';
+        $bucket = 'minio-test-bucket';
+
+        $this->object = new MinIO($this->root, $key, $secret, $protocol, $host, $bucket, MinIO::EU_CENTRAL_1);
+
+    }
+
+    protected function getAdapterName(): string
+    {
+        return 'MinIO Object Storage';
+    }
+
+    protected function getAdapterDescription(): string
+    {
+        return 'MinIO Object Storage';
+    }
+}