Add support of the cloud providers storages

[francoispluchino]

Currently, TUS PHP does not work with stream wrappers from cloud providers such as AWS S3.

This pull request makes TUS PHP compatible with stream wrappers and cloud providers storages.

Regarding DIRECTORY_SEPARATOR, there is no need to use (for this use case) it since Windows handles the slash for directories very well.

Regarding APPEND_BINARY, the cloud provider storages can only open a read or write stream, but not both.

[samundra]

Hi @francoispluchino

Is there any easier way to verify that the changes work as expected?

A step by step guideline or simple how-to would be nice.

[francoispluchino]

AWS S3 Bucket

1. Create an AWS account
2. Connect to the AWS Console
3. Open the S3 service
4. Create your bucket (and keep the bucket name for after)
5. Create a server app

Server app

Install the deps

composer init -n
composer require ankitpokhrel/tus-php aws/aws-sdk-php

Create the server.php file

touch server.php

<?php

require 'vendor/autoload.php';

use Aws\S3\S3Client;
use Aws\Credentials\Credentials;
use TusPhp\Tus\Server;

$awsAccessKey = 'AWS_ACCESS_KEY';// YOUR AWS ACCESS KEY
$awsSecretKey = 'AWS_SECRET_KEY';// YOUR AWS SECRET KEY
$awsRegion = 'eu-west-1';// YOUR AWS BUCKET REGION
$basePath = 's3://your-bucket-name';// YOUR BUCKET NAME

$s3Client = new S3Client([
    'version' => 'latest',
    'region' => $awsRegion,
    'credentials' => new Credentials($awsAccessKey, $awsSecretKey)
]);
$s3Client->registerStreamWrapper();

$server = new Server('file');
$server->setUploadDir($basePath);

$response = $server->serve();
$response->send();

exit(0);

[ankitpokhrel]

Thanks!

[francoispluchino]

Thank you