keboola/php-file-storage-utils

Set of helpers and abstractions above file storage providers

v0.2.6 2023-02-02 15:13 UTC

Requires

• php: >=7.1
• ext-fileinfo: *
• guzzlehttp/guzzle: ^6.5|^7.2
• guzzlehttp/psr7: ^1.7.0|^2.0
• microsoft/azure-storage-blob: ^1.5
• psr/log: ^1|^2|^3
• symfony/process: ^4.4|^5|^6

Requires (Dev)

• keboola/coding-standard: >=9.0
• php-parallel-lint/php-parallel-lint: ^1.2
• phpstan/extension-installer: ^1.0
• phpstan/phpstan: ^0.12.54|^1.0
• phpstan/phpstan-phpunit: ^0.12.16|^1.0
• phpunit/phpunit: ^7|^9.0

MIT

• Keboola

• storage
• s3
• aws
• azure
• blob
• keboola

README

PHP utils around Azure blob storage and Amazon S3

Installation

composer require keboola/php-file-storage-utils

Usage

Azure Blob storage

Retry middleware

$blobClient = BlobRestProxy::createBlobService(...);
$blobClient->pushMiddleware(Keboola\FileStorage\Abs\RetryMiddlewareFactory::create(
        (optional) RetryMiddlewareFactory::DEFAULT_NUMBER_OF_RETRIES,
        (optional) RetryMiddlewareFactory::DEFAULT_RETRY_INTERVAL,
        (optional) RetryMiddlewareFactory::EXPONENTIAL_INTERVAL_ACCUMULATION
));

Best practice

use ClientFactory to preset client and middlewares

\Keboola\FileStorage\Abs\ClientFactory::createClientFromConnectionString(
        string $connectionString,
        ?LoggerInterface $logger = null
);

Development

Run tests with:

docker-compose run --rm testsXX

where XX is PHP version (71 - 74), e.g.:

docker-compose run --rm tests71

Resources Setup

Azure blob storage

export PHP_FS_UTILS_RG=testing-php-file-storage-utils

Create a resource group:

az group create --name $PHP_FS_UTILS_RG --location "northeurope"

Deploy the storage account

az group deployment create --resource-group $PHP_FS_UTILS_RG --template-file arm-template.json

command will output ABS_ACCOUNT_NAME, ABS_ACCOUNT_KEY which has to be added to .env file