README

Community-driven PHP SDKs for Azure, because Microsoft won't.

In November 2023, Microsoft officially archived their Azure SDK for PHP and stopped maintaining PHP integrations for most Azure services. No migration path, no replacement — just a repository marked read-only.

We picked up where they left off.

This package is the Symfony bridge for azure-oss/storage-blob-flysystem. It registers a azure_oss adapter shortcut with league/flysystem-bundle so storages can be declared directly in config/packages/flysystem.yaml.

Our other packages:

• azure-oss/storage – Azure Blob Storage SDK
• azure-oss/storage-blob-flysystem – Flysystem adapter
• azure-oss/storage-blob-laravel – Laravel filesystem driver
• azure-oss/storage-queue – Azure Storage Queue SDK
• azure-oss/storage-queue-laravel – Laravel Queue connector

Requirements

• PHP 8.2+
• league/flysystem-bundle 3.7 or newer (the version that introduced the pluggable AdapterDefinitionBuilderInterface).

Install

composer require azure-oss/storage-blob-symfony

If you have Symfony Flex installed it will register AzureOss\Storage\BlobFlysystemSymfony\AzureStorageBlobFlysystemBundle for you. Otherwise add it to config/bundles.php:

return [
    // ...
    AzureOss\Storage\BlobSymfony\AzureStorageBlobFlysystemBundle::class => ['all' => true],
];

Quickstart

Declare a BlobServiceClient service and reference it from a flysystem storage that uses the azure_oss adapter:

# config/services.yaml
services:
    azure_blob_service_client:
        class: AzureOss\Storage\Blob\BlobServiceClient
        factory: ['AzureOss\Storage\Blob\BlobServiceClient', 'fromConnectionString']
        arguments:
            - '%env(AZURE_STORAGE_CONNECTION_STRING)%'

# config/packages/flysystem.yaml
flysystem:
    storages:
        default.storage:
            azure_oss:
                client: azure_blob_service_client
                container: '%env(AZURE_STORAGE_CONTAINER)%'
                # Optional:
                # prefix: 'optional/path/prefix'
                # mime_type_detector: 'my.custom.mime_type_detector'
                # visibility_handling: throw  # or 'ignore'
                # public_container: false
            visibility: public

You can now autowire the storage anywhere:

use League\Flysystem\FilesystemOperator;

final class MyService
{
    public function __construct(
        private readonly FilesystemOperator $defaultStorage,
    ) {
    }
}

Configuration reference

Authentication

Authentication is delegated to whatever BlobServiceClient you supply via client. Besides connection strings the SDK supports SAS tokens and token-based credentials (Entra ID, managed identity, workload identity). See the azure-oss/storage documentation for the full set of authentication helpers.

License

This project is released under the MIT License. See LICENSE for details.