Added MinIO Storage adapter

[groschi24]

What does this PR do?

Implements a new Adapter for MinIO.

Test Plan

(Write your test plan here. If you changed any code, please provide us with clear instructions on how you verified your changes work.)

Implemented new Adapter, tested with vendor/bin/phpunit and custom function test ( code below )

<?php

require_once './vendor/autoload.php';

use Utopia\Storage\Storage;
use Utopia\Storage\Device\MinIO;

Storage::setDevice('files', new MinIO('<YOUR_BUCKET>', '<ACCESS_KEY>', '<SECRET_KEY>', '<PROTOCOL http or https>', '<HOST e.g. minio.example.com>', '<YOUR_BUCKET>', '<REGION e.g. eu-central-1>'));

$device = Storage::getDevice('files');

// Upload File
$device->upload('./test.txt','<YOUR_BUCKET>/test.txt');

// Upload File - Multipart
$metadata = ["content_type" => "application/json"];
$device->upload('./test.json','<YOUR_BUCKET>/test.json', 2, 1, $metadata);

// Read
echo "Read File: ";
var_dump($device->read('<YOUR_BUCKET>/test.txt'));
echo "\r\n";

// Move File
$device->move('<YOUR_BUCKET>/test.txt', '<YOUR_BUCKET>/bucket/test.txt');

// Delete
$device->delete('<YOUR_BUCKET>/bucket/test.txt');
$device->delete('<YOUR_BUCKET>/bucket');

// Delete Path
$device->upload('./test.txt','<YOUR_BUCKET>/bucket/test.txt');
$device->delete('<YOUR_BUCKET>/bucket/test.txt');

// File Size
echo "File Size: ";
var_dump($device->getFileSize('<YOUR_BUCKET>/test.json'));
echo "\r\n";

Related PRs and Issues

(If this PR is related to any other PR or resolves any issue or related to any issue link all related PR and issues here.)

Issue #37

Have you read the Contributing Guidelines on issues?
(Write your answer here.)
Yes

[shimonewman]

Suggested change

	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)
	public function __construct(string $root, string $accessKey, string $secretKey, string $host, string $bucket, string $region = self::EU_CENTRAL_1, string $acl = self::ACL_PRIVATE)

https://github.com/minio/minio-js/blob/master/src/main/minio.js#L70
Please avoid changing the signature of the constructor. These days it is very uncommon to use HTTP so let's default to HTTPS like the official SDK.

[groschi24]

Hi @shimonewman,

thanks for the review. The problem is that in my setup MinIO is in a Self Hosted Private Network so I access it with the internal IP so it don't have an https protocol.

[shimonewman]

Suggested change

* @param string $protocol

[groschi24]

Protocol has to be here, because MinIO can be hosted in an internal Network, where you don't have SSL

[shimonewman]

Suggested change

	public function call(string $method, string $uri, string $data = '', array $parameters=[])
	private function call(string $method, string $uri, string $data = '', array $parameters=[])

Please avoid changing the access modifiers

[shimonewman]

Suggested change

	public function listObjects($prefix = '', $maxKeys = 1000, $continuationToken = '')
	private function listObjects($prefix = '', $maxKeys = 1000, $continuationToken = '')

Please change S3 listObjects() access modifiers to protected in order for you to override it.

[shimonewman]

Suggested change

$protocol = $_SERVER['MINIO_PROTOCOL'] ?? '';

[groschi24]

Protocol has to be here, because MinIO can be hosted in an internal Network, where you don't have SSL

[shimonewman]

Suggested change

	$this->object = new MinIO($this->root, $key, $secret, $protocol, $host, $bucket, MinIO::EU_CENTRAL_1);
	$this->object = new MinIO($this->root, $key, $secret, $host, $bucket, MinIO::EU_CENTRAL_1);

[groschi24]

Protocol has to be here, because MinIO can be hosted in an internal Network, where you don't have SSL

[shimonewman]

Awesome work!! few more changes and then we can merge

[eldadfux]

I think it might be better to adapt all adapters to use and endpoint instead of protocol and hostname for more flexibility. Hardcoding https:// is wrong to begin with.

[groschi24]

Would leave it for now and make it in another Pull Request

[shimonewman]

@groschi24, please create another PR with the proposed changes to the endpoint.

[stnguyen90]

@groschi24 sorry looks like there are merge conflicts now. Would you be able to fix the merge conflicts?

[F4LS3]

Any hope that this will be merged soon?