azure-oss/storage

Azure Blob Storage PHP SDK

1.8.0 2026-03-05 20:31 UTC

Requires

• php: ^8.1
• ext-curl: *
• ext-json: *
• ext-simplexml: *
• azure-oss/storage-common: ^1.0
• caseyamcl/guzzle_retry_middleware: ^2.10
• guzzlehttp/guzzle: ^7.8

MIT

• Brecht Vermeersch
• Pim Jansen

• php
• storage
• sdk
• azure

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.

Our other packages:

• azure-oss/storage-blob-flysystem – Flysystem adapter
  

• azure-oss/storage-blob-laravel – Laravel filesystem driver
  

Documentation

You can read the documentation here.

Install

composer require azure-oss/storage

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.