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.

Package ecosystem

• azure-oss/storage — Meta package for the Storage SDKs
  • azure-oss/storage-common — Shared authentication, HTTP, and SAS primitives
  • azure-oss/storage-blob — Blob Storage SDK
    • azure-oss/storage-blob-flysystem — Flysystem adapter
    • azure-oss/storage-blob-laravel — Laravel filesystem driver
    • azure-oss/storage-blob-symfony — Symfony Flysystem bridge
  • azure-oss/storage-queue — Queue Storage SDK
    • azure-oss/storage-queue-laravel — Laravel queue connector
  • azure-oss/storage-file-share — File Share SDK (under construction)
• azure-oss/identity — Microsoft Entra ID token authentication

Features

• Authentication:
  • Connection strings (access keys)
  • Shared key credentials
  • Shared access signatures (SAS) for delegated, time-limited access
  • Microsoft Entra ID (token-based authentication) via azure-oss/azure-identity
• Local development:
  • Supports the Azurite emulator
• Containers:
  • Create, delete, and list (including filtering by prefix)
  • Configure public access when creating a container
  • Read properties and manage metadata
  • Acquire, renew, change, release, and break leases
  • List and restore soft-deleted containers
• Blobs:
  • Upload from strings or streams, with transfer tuning for large uploads
  • Set common HTTP headers (content type, cache control, etc.)
  • Download via streaming and access response properties
  • Protect reads and writes with ETag, date, and lease ID conditions
  • Acquire, renew, change, release, and break leases
  • Copy blobs (synchronous and asynchronous)
  • List blobs (flat, by prefix, and hierarchical listing) with page sizing
  • Delete and restore soft-deleted blobs
  • Create, read, copy, and delete snapshots
  • Select, read, restore, and delete blob versions
  • Read properties and manage metadata
  • Blob index tags: set/get tags and query blobs by tags (account or container scope)
• SAS:
  • Generate SAS for blobs, containers, and the account (when using credentials that can sign SAS)

Documentation

You can read the documentation here.

Install

composer require azure-oss/storage-blob

Quickstart

<?php

use AzureOss\Storage\Blob\BlobServiceClient;
use AzureOss\Storage\Blob\Models\UploadBlobOptions;

$service = BlobServiceClient::fromConnectionString(
    getenv('AZURE_STORAGE_CONNECTION_STRING')
);

$container = $service->getContainerClient('quickstart');
$container->createIfNotExists();

$blob = $container->getBlobClient('hello.txt');

$blob->upload(
    'Hello from Azure-OSS',
    new UploadBlobOptions(contentType: 'text/plain')
);

$download = $blob->downloadStreaming();
$content = $download->content->getContents();

echo $content.PHP_EOL; // Hello from Azure-OSS

foreach ($container->getBlobs() as $item) {
    echo $item->name.PHP_EOL;
}

// Optional cleanup
$blob->deleteIfExists();
// $container->deleteIfExists();

License

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