azure-oss/storage-blob-flysystem

Flysystem adapter for Azure Storage PHP

1.2.0 2024-11-09 09:32 UTC

This package is auto-updated.

Last update: 2024-12-21 18:37:36 UTC


README

Latest Version on Packagist Packagist Downloads GitHub Workflow Status

Warning

Data Lake Storage (Storage Account with hierarchical namespace enabled) is unsupported.

Minimum Requirements

  • PHP 8.1 or above
  • Required PHP extensions
    • curl
    • json
    • xml

Install

composer require azure-oss/storage-blob-flysystem

Quickstart

use AzureOss\FlysystemAzureBlobStorage\AzureBlobStorageAdapter;
use AzureOss\Storage\Blob\BlobServiceClient;
use League\Flysystem\Filesystem;

$blobServiceClient = BlobServiceClient::fromConnectionString('<connection-string>');
$containerClient = $blobServiceClient->getContainerClient('quickstart');

$adapter = new AzureBlobStorageAdapter($containerClient, "optional/prefix");
$filesystem = new Filesystem($adapter);

$filesystem->write('hello', 'world!');

Documentation

For more information visit the documentation at azure-oss.github.io.

Support

Do you need help, do you want to talk to us, or is there anything else?

Join us at:

License

Azure-Storage-PHP-Adapter-Flysystem is released under the MIT License. See LICENSE for details.

PHP Version Support Policy

The maintainers of this package add support for a PHP version following its initial release and drop support for a PHP version once it has reached its end of security support.

Backward compatibility promise

Azure-Storage-PHP is using Semver. This means that versions are tagged with MAJOR.MINOR.PATCH. Only a new major version will be allowed to break backward compatibility (BC).

Classes marked as @experimental or @internal are not included in our backward compatibility promise. You are also not guaranteed that the value returned from a method is always the same. You are guaranteed that the data type will not change.

PHP 8 introduced named arguments, which increased the cost and reduces flexibility for package maintainers. The names of the arguments for methods in the library are not included in our BC promise.