PHPackages                             league/flysystem - 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. league/flysystem

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

league/flysystem
================

File storage abstraction for PHP

3.33.0(1mo ago)13.6k639.1M↓12.1%852[84 issues](https://github.com/thephpleague/flysystem/issues)[14 PRs](https://github.com/thephpleague/flysystem/pulls)20MITPHPPHP ^8.0.2CI passing

Since Oct 28Pushed 4d ago162 watchersCompare

[ Source](https://github.com/thephpleague/flysystem)[ Packagist](https://packagist.org/packages/league/flysystem)[ RSS](/packages/league-flysystem/feed)WikiDiscussions 3.x Synced 1mo ago

READMEChangelog (10)Dependencies (30)Versions (264)Used By (20)Security (1)

League\\Flysystem
=================

[](#leagueflysystem)

[![Author](https://camo.githubusercontent.com/d7d52362024683450617985055436a3ef44d3c2209c7ace3efdbdcd91f8324e4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d406672616e6b64656a6f6e67652d626c75652e737667)](https://twitter.com/frankdejonge)[![Source Code](https://camo.githubusercontent.com/b9b6e508981a240a265e1edfdd6b608a5dd2242506079b350ae7bf0b723e14c8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f736f757263652d7468657068706c65616775652f666c7973797374656d2d626c75652e737667)](https://github.com/thephpleague/flysystem)[![Latest Version](https://camo.githubusercontent.com/4e3a47cb1b6e5872efc595116885b8c68203e10b8957a3a07bc16a7aa80633d1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f7468657068706c65616775652f666c7973797374656d2e737667)](https://github.com/thephpleague/flysystem/releases)[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](https://github.com/thephpleague/flysystem/blob/master/LICENSE)[![Quality Assurance](https://github.com/thephpleague/flysystem/workflows/Quality%20Assurance/badge.svg?branch=2.x)](https://github.com/thephpleague/flysystem/actions?query=workflow%3A%22Quality+Assurance%22)[![Total Downloads](https://camo.githubusercontent.com/a529cbf28b29a329455a0f3bec7e1b0c01070cede7187a4688132d99bb83be64/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c65616775652f666c7973797374656d2e737667)](https://packagist.org/packages/league/flysystem)[![php 7.2+](https://camo.githubusercontent.com/c832a65c1614b9d497140a690d7b2b5533f493360c89d2efd008ae08ee9f673c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d6d696e253230382e302e322d7265642e737667)](https://camo.githubusercontent.com/c832a65c1614b9d497140a690d7b2b5533f493360c89d2efd008ae08ee9f673c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d6d696e253230382e302e322d7265642e737667)

About Flysystem
---------------

[](#about-flysystem)

Flysystem is a file storage library for PHP. It provides one interface to interact with many types of filesystems. When you use Flysystem, you're not only protected from vendor lock-in, you'll also have a consistent experience for which ever storage is right for you.

Getting Started
---------------

[](#getting-started)

- **[New in V3](https://flysystem.thephpleague.com/docs/what-is-new/)**: What is new in Flysystem V2/V3?
- **[Architecture](https://flysystem.thephpleague.com/docs/architecture/)**: Flysystem's internal architecture
- **[Flysystem API](https://flysystem.thephpleague.com/docs/usage/filesystem-api/)**: How to interact with your Flysystem instance
- **[Upgrade from 1x](https://flysystem.thephpleague.com/docs/upgrade-from-1.x/)**: How to upgrade from 1.x/2.x

### Officially supported adapters

[](#officially-supported-adapters)

- **[Local](https://flysystem.thephpleague.com/docs/adapter/local/)**
- **[FTP](https://flysystem.thephpleague.com/docs/adapter/ftp/)**
- **[SFTP](https://flysystem.thephpleague.com/docs/adapter/sftp-v3/)**
- **[Memory](https://flysystem.thephpleague.com/docs/adapter/in-memory/)**
- **[AWS S3](https://flysystem.thephpleague.com/docs/adapter/aws-s3-v3/)**
- **[AsyncAws S3](https://flysystem.thephpleague.com/docs/adapter/async-aws-s3/)**
- **[Google Cloud Storage](https://flysystem.thephpleague.com/docs/adapter/google-cloud-storage/)**
- **[MongoDB GridFS](https://flysystem.thephpleague.com/docs/adapter/gridfs/)**
- **[WebDAV](https://flysystem.thephpleague.com/docs/adapter/webdav/)**
- **[ZipArchive](https://flysystem.thephpleague.com/docs/adapter/zip-archive/)**

### Third party Adapters

[](#third-party-adapters)

- **[Azure Blob Storage](https://github.com/Azure-OSS/azure-storage-php-adapter-flysystem)**
- **[Gitlab](https://github.com/RoyVoetman/flysystem-gitlab-storage)**
- **[Google Drive (using regular paths)](https://github.com/masbug/flysystem-google-drive-ext)**
- **[bunny.net / BunnyCDN](https://github.com/PlatformCommunity/flysystem-bunnycdn/tree/v3)**
- **[Sharepoint 365 / One Drive (Using MS Graph)](https://github.com/shitware-ltd/flysystem-msgraph)**
- **[OneDrive](https://github.com/doerffler/flysystem-onedrive)**
- **[Dropbox](https://github.com/spatie/flysystem-dropbox)**
- **[ReplicateAdapter](https://github.com/ajgarlag/flysystem-replicate)**
- **[Uploadcare](https://github.com/vormkracht10/flysystem-uploadcare)**
- **[Useful adapters (FallbackAdapter, LogAdapter, ReadWriteAdapter, RetryAdapter)](https://github.com/ElGigi/FlysystemUsefulAdapters)**
- **[Metadata Cache](https://github.com/jgivoni/flysystem-cache-adapter)**
- **[Migration adapter (lazy)](https://github.com/antonsacred/flysystem-lazy-migration-adapter)**

You can always [create an adapter](https://flysystem.thephpleague.com/docs/advanced/creating-an-adapter/) yourself.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Enjoy
-----

[](#enjoy)

Oh, and if you've come down this far, you might as well follow me on [twitter](https://twitter.com/frankdejonge).

###  Health Score

87

—

ExcellentBetter than 100% of packages

Maintenance94

Actively maintained with recent releases

Popularity90

Widely adopted with strong download metrics

Community66

Healthy contributor diversity

Maturity88

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 86.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

Every ~17 days

Recently: every ~33 days

Total

257

Last Release

55d ago

Major Versions

2.4.4 → 3.0.172022-04-14

2.4.5 → 3.0.182022-04-25

2.5.0 → 3.5.02022-09-17

1.x-dev → 3.6.02022-10-13

3.30.1 → 4.x-dev2025-10-20

PHP version history (8 changes)0.5.0PHP &gt;=5.4.0

1.0.29PHP &gt;=5.6.0

1.0.30PHP &gt;=5.5.9

2.0.0-alpha.1PHP ^7.2

1.1.0PHP ^7.2.5 || ^8.0

2.0.0PHP ^7.2 || ^8.0

3.0.0PHP ^8.0.2

4.x-devPHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/534693?v=4)[Frank de Jonge](/maintainers/frankdejonge)[@frankdejonge](https://github.com/frankdejonge)

---

Top Contributors

[![frankdejonge](https://avatars.githubusercontent.com/u/534693?v=4)](https://github.com/frankdejonge "frankdejonge (994 commits)")[![tinect](https://avatars.githubusercontent.com/u/135993?v=4)](https://github.com/tinect "tinect (17 commits)")[![kbond](https://avatars.githubusercontent.com/u/127811?v=4)](https://github.com/kbond "kbond (15 commits)")[![GromNaN](https://avatars.githubusercontent.com/u/400034?v=4)](https://github.com/GromNaN "GromNaN (13 commits)")[![PhilinTv](https://avatars.githubusercontent.com/u/376033?v=4)](https://github.com/PhilinTv "PhilinTv (12 commits)")[![jnoordsij](https://avatars.githubusercontent.com/u/45041769?v=4)](https://github.com/jnoordsij "jnoordsij (12 commits)")[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (12 commits)")[![Warxcell](https://avatars.githubusercontent.com/u/3340882?v=4)](https://github.com/Warxcell "Warxcell (11 commits)")[![erikn69](https://avatars.githubusercontent.com/u/4933954?v=4)](https://github.com/erikn69 "erikn69 (6 commits)")[![ElGigi](https://avatars.githubusercontent.com/u/18268216?v=4)](https://github.com/ElGigi "ElGigi (5 commits)")[![DannyvdSluijs](https://avatars.githubusercontent.com/u/618940?v=4)](https://github.com/DannyvdSluijs "DannyvdSluijs (5 commits)")[![lcobucci](https://avatars.githubusercontent.com/u/201963?v=4)](https://github.com/lcobucci "lcobucci (5 commits)")[![n1crack](https://avatars.githubusercontent.com/u/712404?v=4)](https://github.com/n1crack "n1crack (4 commits)")[![ajgarlag](https://avatars.githubusercontent.com/u/388184?v=4)](https://github.com/ajgarlag "ajgarlag (4 commits)")[![stevenrombauts](https://avatars.githubusercontent.com/u/77368?v=4)](https://github.com/stevenrombauts "stevenrombauts (4 commits)")[![Lctrs](https://avatars.githubusercontent.com/u/5477973?v=4)](https://github.com/Lctrs "Lctrs (3 commits)")[![Slamdunk](https://avatars.githubusercontent.com/u/152236?v=4)](https://github.com/Slamdunk "Slamdunk (3 commits)")[![OskarStark](https://avatars.githubusercontent.com/u/995707?v=4)](https://github.com/OskarStark "OskarStark (3 commits)")[![amenophis](https://avatars.githubusercontent.com/u/2158235?v=4)](https://github.com/amenophis "amenophis (3 commits)")[![yoeriboven](https://avatars.githubusercontent.com/u/4047804?v=4)](https://github.com/yoeriboven "yoeriboven (2 commits)")

---

Tags

filesystemfilesystem-libraryphpthephpleagueftpfilesystems3awscloudsftpfilefilesstorageWebDAVfilesystems

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/league-flysystem/health.svg)

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

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

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

The flysystem extension for the Yii framework

2931.7M62](/packages/creocoder-yii2-flysystem)[league/flysystem-async-aws-s3

AsyncAws S3 filesystem adapter for Flysystem.

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

PHPackages © 2026

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