PHPackages                             azuracast/flysystem-v2-extensions - 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 &amp; Storage](/categories/file-storage)
4. /
5. azuracast/flysystem-v2-extensions

AbandonedArchivedLibrary[File &amp; Storage](/categories/file-storage)

azuracast/flysystem-v2-extensions
=================================

Extensions to Flysystem V2 functionality.

1.0.0(4y ago)211.9k↓12.5%3MITPHPPHP ^7.4 || ^8.0

Since Jun 21Pushed 3y ago2 watchersCompare

[ Source](https://github.com/AzuraCast/flysystem-v2-extensions)[ Packagist](https://packagist.org/packages/azuracast/flysystem-v2-extensions)[ GitHub Sponsors](https://github.com/AzuraCast)[ Fund](https://opencollective.com/azuracast)[ RSS](/packages/azuracast-flysystem-v2-extensions/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (7)Versions (2)Used By (0)

AzuraCast Flysystem V2 Extensions
=================================

[](#azuracast-flysystem-v2-extensions)

This library contains extended functionality for version 2 of the [Flysystem](https://flysystem.thephpleague.com) file abstraction library.

Much of the functionality is intended to restore a user experience similar to Flysystem V1 and to allow for easier customization of Flysystem for third-party purposes.

Any portion of the extended classes can be used interchangeably with the base Flysystem classes.

Added Functionality
-------------------

[](#added-functionality)

### Extended Adapters

[](#extended-adapters)

- **getMetadata Function:** Supported adapters have had a `getMetadata` call added to replace the need for separate metadata calls, in keeping with the functionality of Flysystem 1.x. This also reduces redundant API calls if you need the full metadata for a file and use the `getMetadata` function at the Filesystem level.
- **Lazy-Loading StorageAttributes:** To ensure all metadata is available in the `StorageAttributes` return object, even if some items may be more computationally expensive, some metadata attributes can be supplied as callable functions that resolve when called. This is currently only the case for the `visibility` attribute, because it's the most computationally intensive one.
- **On-Disk Adapter Optimizations:** The local, on-disk adapter implements a new `LocalAdapterInterface` with a single method: `getLocalPath`; if your application has optimizations built in for on-disk filesystems, this allows you to immediately identify if the filesystem you're using is on-disk or not.

### Filesystem Changes

[](#filesystem-changes)

- Additional metadata functions are exposed:

    - `getMetadata` to return any available `StorageAttributes` in one object
    - `isFile`, which corresponds to the `isFile()` function in `StorageAttributes`
    - `isDir`, which corresponds to the `isDir()` function in `StorageAttributes`
- A new method, `getAdapter`, is exposed that allows direct access to the underlying adapter interface.
- Helper classes and methods to further distinguish between local and remote filesystems:

    - `LocalFilesystem` intended for use with the `LocalFilesystemAdapter`
    - `RemoteFilesystem` with an optional `$local_path` parameter, intended for remote adapters that still may need a temporary local file to be created for interaction with other scripts,
    - `upload`, a helper which copies from the local disk to the destination filesystem,
    - `download`, a helper which copies from the source filesystem to the local disk,
    - `withLocalFile`, a helper which supplies a callable function with a path to a file that is guaranteed to be on-disk, even if the filesystem itself is remote.

Supported Adapters
------------------

[](#supported-adapters)

Currently, this library is a monorepo consisting of all adapters used by the primary application making use of this library:

- **Local**: A local, on-disk filesystem.
- **AwsS3**: A remote filesystem for cloud storage supporting the AWS S3 storage API.
- **Dropbox**: A remote filesystem for cloud storage on the Dropbox application.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 65.2% of commits — single point of failure

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

Unknown

Total

1

Last Release

1793d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c93ad1068589452b1a3a4e436439bc66fcab0b8252a7a0c7a7d11557e4f3110a?d=identicon)[SlvrEagle23](/maintainers/SlvrEagle23)

---

Top Contributors

[![BusterNeece](https://avatars.githubusercontent.com/u/6744885?v=4)](https://github.com/BusterNeece "BusterNeece (15 commits)")[![Vaalyn](https://avatars.githubusercontent.com/u/13745863?v=4)](https://github.com/Vaalyn "Vaalyn (8 commits)")

---

Tags

filesystems3awscloudfilefilesstoragefilesystems

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/azuracast-flysystem-v2-extensions/health.svg)

```
[![Health](https://phpackages.com/badges/azuracast-flysystem-v2-extensions/health.svg)](https://phpackages.com/packages/azuracast-flysystem-v2-extensions)
```

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k639.1M2.2k](/packages/league-flysystem)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

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

AsyncAws S3 filesystem adapter for Flysystem.

2610.5M31](/packages/league-flysystem-async-aws-s3)[creocoder/yii2-flysystem

The flysystem extension for the Yii framework

2931.7M62](/packages/creocoder-yii2-flysystem)

PHPackages © 2026

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