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 )

<?phprequire_once'./vendor/autoload.php';
useUtopia\Storage\Storage;
useUtopia\Storage\Device\MinIO;
Storage::setDevice('files', newMinIO('<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);
// Readecho"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 Sizeecho"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

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

	publicfunction call(string$method, string$uri, string$data = '', array$parameters=[])
	privatefunction call(string$method, string$uri, string$data = '', array$parameters=[])

Please avoid changing the access modifiers

[shimonewman]

Suggested change

	publicfunction listObjects($prefix = '', $maxKeys = 1000, $continuationToken = '')
	privatefunction 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 = newMinIO($this->root, $key, $secret, $protocol, $host, $bucket, MinIO::EU_CENTRAL_1);
	$this->object = newMinIO($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?

[linus-ende]

Any hope that this will be merged soon?