PHPackages                             consilience/flysystem-azure-file-storage - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. consilience/flysystem-azure-file-storage

ActiveLibrary[File & Storage](/categories/file-storage)

consilience/flysystem-azure-file-storage
========================================

Flysystem adapter for Windows Azure File Storage

1.0.0(3y ago)6185.7k↓23.4%2[5 issues](https://github.com/consilience/flysystem-azure-file-storage/issues)2MITPHPPHP >=8.1.0

Since Feb 25Pushed 3y ago1 watchersCompare

[ Source](https://github.com/consilience/flysystem-azure-file-storage)[ Packagist](https://packagist.org/packages/consilience/flysystem-azure-file-storage)[ RSS](/packages/consilience-flysystem-azure-file-storage/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (6)Versions (10)Used By (2)

[![Latest Stable Version](https://camo.githubusercontent.com/f1c1c3761b1d2e39290ca1c39801cb700eb85eb9d7ce811f3dd6583adce4c209/68747470733a2f2f706f7365722e707567782e6f72672f636f6e73696c69656e63652f666c7973797374656d2d617a7572652d66696c652d73746f726167652f762f737461626c65)](https://packagist.org/packages/consilience/flysystem-azure-file-storage)[![Total Downloads](https://camo.githubusercontent.com/1bcd004ade49913ab0cc501c9ad67980676a1fd69f79333d1b9deef78f3172f7/68747470733a2f2f706f7365722e707567782e6f72672f636f6e73696c69656e63652f666c7973797374656d2d617a7572652d66696c652d73746f726167652f646f776e6c6f616473)](https://packagist.org/packages/consilience/flysystem-azure-file-storage)[![Latest Unstable Version](https://camo.githubusercontent.com/641f6a2608044def70b349ac22ecb0d62cee82e63b596a45fccc1fe4bf52745a/68747470733a2f2f706f7365722e707567782e6f72672f636f6e73696c69656e63652f666c7973797374656d2d617a7572652d66696c652d73746f726167652f762f756e737461626c65)](https://packagist.org/packages/consilience/flysystem-azure-file-storage)[![License](https://camo.githubusercontent.com/e9874e3cf541f64c32f051ab00a1cf3a4c6c686673656bd54d79d7a7bc4d4a19/68747470733a2f2f706f7365722e707567782e6f72672f636f6e73696c69656e63652f666c7973797374656d2d617a7572652d66696c652d73746f726167652f6c6963656e7365)](https://packagist.org/packages/consilience/flysystem-azure-file-storage)

Azure File Storage adapter for Flysystem
========================================

[](#azure-file-storage-adapter-for-flysystem)

This repo is fork of [League\\Flysystem\\Azure](https://github.com/thephpleague/flysystem-azure)with the underlying Azure API library changed from `microsoft/azure-storage`to `microsoft/azure-storage-file`. The original driver supports Azure blob storage, with a flat binary object structure. This driver supports Azure file storage, which includes directory capabilities.

A separate service provider package for Laravel 5.5+ is available here: The service provider allows Azure File Storage shares tbe be used as a native filesystem within Laravel.

Installation
============

[](#installation)

Install package

```
composer require consilience/flysystem-azure-file-storage
```

How to use this driver
======================

[](#how-to-use-this-driver)

*Note: if you are using Laravel then the [filesystem driver](https://github.com/academe/laravel-azure-file-storage-driver)will wrap and abstract all of this for you.*

```
use League\Flysystem\Filesystem;
use Consilience\Flysystem\Azure\AzureFileAdapter;
use MicrosoftAzure\Storage\File\FileRestProxy;
use Illuminate\Support\ServiceProvider;

// A helper method for constructing the connectionString may be usedful,
// if there is a demand.

$connectionString = sprintf(
    'DefaultEndpointsProtocol=https;AccountName=%s;AccountKey=%s',
    '{storage account name}',
    '{file storage key}'
);

$config = [
    'endpoint' => $connectionString,
    'container' => '{file share name}',
    // Optional to prevent directory deletion recursively deleting
    // all descendant files and direcories.
    //'disableRecursiveDelete' => true,
    // Optional driver options can also be added here. e.g. CacheControl, Metadata.
];

$fileService = FileRestProxy::createFileService(
    $connectionString,
    [] // $optionsWithMiddlewares
);

$filesystem = new Filesystem(new AzureFileAdapter(
    $fileService,
    $config,
    'optional-directory-prefix'
));

// Now the $filesystem object can be used as a standard
// Flysystem file system.
// See https://flysystem.thephpleague.com/api/

// A few examples:

$content    = $filesystem->read('path/to/my/file.txt');
$resource   = $filesystem->readResource('path/to/my/file.txt');
$success    = $filesystem->createDir('new/directory/here');
$success    = $filesystem->rename('path/to/my/file.txt', 'some/other/folder/another.txt');

// The URL of a file can be found like this:

$url = $filesystem->getAdapter()->getUrl('path/to/my/foo.bar');
```

Testing
-------

[](#testing)

Set up `.env` and run live tests:

```
composer install
vendor/bin/phpunit --testsuite flysystem-azure-live-tests

```

These will create/delete a few test files and directories in the root of the Azure file share.

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance3

Infrequent updates — may be unmaintained

Popularity39

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~222 days

Recently: every ~350 days

Total

8

Last Release

1448d ago

Major Versions

0.1.6 → 1.0.02022-05-31

PHP version history (3 changes)0.1.0PHP >=5.6.0

0.1.5PHP >=7.2.0

1.0.0PHP >=8.1.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/395934?v=4)[Jason Judge](/maintainers/judgej)[@judgej](https://github.com/judgej)

---

Top Contributors

[![judgej](https://avatars.githubusercontent.com/u/395934?v=4)](https://github.com/judgej "judgej (23 commits)")[![frankdejonge](https://avatars.githubusercontent.com/u/534693?v=4)](https://github.com/frankdejonge "frankdejonge (20 commits)")[![ijin82](https://avatars.githubusercontent.com/u/612918?v=4)](https://github.com/ijin82 "ijin82 (8 commits)")[![maetthu](https://avatars.githubusercontent.com/u/1193955?v=4)](https://github.com/maetthu "maetthu (3 commits)")[![zaak](https://avatars.githubusercontent.com/u/803299?v=4)](https://github.com/zaak "zaak (3 commits)")[![icewind1991](https://avatars.githubusercontent.com/u/1283854?v=4)](https://github.com/icewind1991 "icewind1991 (2 commits)")[![guiwoda](https://avatars.githubusercontent.com/u/1625545?v=4)](https://github.com/guiwoda "guiwoda (2 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (1 commits)")

---

Tags

azure-storageazure-storage-fileflysystemlaravelphp

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/consilience-flysystem-azure-file-storage/health.svg)

```
[![Health](https://phpackages.com/badges/consilience-flysystem-azure-file-storage/health.svg)](https://phpackages.com/packages/consilience-flysystem-azure-file-storage)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.3M74](/packages/unisharp-laravel-filemanager)[league/flysystem-local

Local filesystem adapter for Flysystem.

225231.8M39](/packages/league-flysystem-local)[league/flysystem-bundle

Symfony bundle integrating Flysystem into Symfony applications

40129.5M87](/packages/league-flysystem-bundle)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6129.6M91](/packages/league-flysystem-sftp-v3)[league/flysystem-memory

In-memory filesystem adapter for Flysystem.

8533.6M194](/packages/league-flysystem-memory)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)