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

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

mazpaijo/flysystem
==================

Filesystem abstraction: Many filesystems, one API.

1.0.48(7y ago)028MITPHPPHP &gt;=5.5.9

Since Oct 28Pushed 7y ago1 watchersCompare

[ Source](https://github.com/mazpaijo/flysystem)[ Packagist](https://packagist.org/packages/mazpaijo/flysystem)[ RSS](/packages/mazpaijo-flysystem/feed)WikiDiscussions master Synced 3d ago

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

Mazpaijo\\Flysystem
===================

[](#mazpaijoflysystem)

[![Author](https://camo.githubusercontent.com/b9e526851cdefc2067ee75a43fd0c07644f5b9a88111e7ca05e6457f906524a4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d406672616e6b64656a6f6e67652d626c75652e7376673f7374796c653d666c61742d737175617265)](https://twitter.com/frankdejonge)[![Build Status](https://camo.githubusercontent.com/af456951adaef8bd0a55d668110e7f9dafd2d25408cc075c1d64c520e17299e2/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f7468657068706c65616775652f666c7973797374656d2f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/thephpleague/flysystem)[![Coverage Status](https://camo.githubusercontent.com/0efcb1fbebc85de3d22f573b3e6ba6cd1b8dc5694f823b660816d4fbba3eba5c/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f7468657068706c65616775652f666c7973797374656d2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/thephpleague/flysystem/code-structure)[![Quality Score](https://camo.githubusercontent.com/ac205e6bf3d2f2b3839e12f06b25ee7cf6c836ea9200f69aa2ef3f733c7c7ab8/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f7468657068706c65616775652f666c7973797374656d2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/thephpleague/flysystem)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Packagist Version](https://camo.githubusercontent.com/df34c026da2dbeb54cd80afad394134ad17dbcc22d1200b10e4ecf25df047a4e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f4d617a7061696a6f2f666c7973797374656d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/Mazpaijo/flysystem)[![Total Downloads](https://camo.githubusercontent.com/8eae1a9ce6bdfae9d5bd246d4f349ea5480f8f68c874272051c5854cf9d1f549/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f4d617a7061696a6f2f666c7973797374656d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/Mazpaijo/flysystem)[![Build status](https://camo.githubusercontent.com/56ef252f3365e67e1c100391078a567c73e8e62d93fef66e356fefb9cd6df44c/68747470733a2f2f696d672e736869656c64732e696f2f6170707665796f722f63692f6672616e6b64656a6f6e67652f666c7973797374656d2f6d61737465722e7376673f7374796c653d666c61742d737175617265266c6f676f3d6170707665796f72)](https://ci.appveyor.com/project/frankdejonge/flysystem/branch/master)

[![SensioLabsInsight](https://camo.githubusercontent.com/5640bdd93950301bbc5065b4070f89a136cfbed664061bb317d537f6d8b8a8b5/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f39383230663161662d326664302d346162362d623432612d3033653063383231653061662f6269672e706e67)](https://insight.sensiolabs.com/projects/9820f1af-2fd0-4ab6-b42a-03e0c821e0af)

Flysystem is a filesystem abstraction which allows you to easily swap out a local filesystem for a remote one.

[![Become a Patron](https://camo.githubusercontent.com/ccdb23ee998793c9138982e6c2ae4d04158152b418918b3aa40bf261e4bf12d1/68747470733a2f2f666c7973797374656d2e7468657068706c65616775652e636f6d2f6c6f676f2f6265636f6d655f615f706174726f6e5f627574746f6e2e706e67)](https://www.patreon.com/bePatron?u=8623643)

Goals
-----

[](#goals)

- Have a generic API for handling common tasks across multiple file storage engines.
- Have consistent output which you can rely on.
- Integrate well with other packages/frameworks.
- Be cacheable.
- Emulate directories in systems that don't support them, like AwsS3.
- Support third party plugins.
- Make it easy to test your filesystem interactions.
- Support streams for big file handling.

Installation
------------

[](#installation)

```
composer require Mazpaijo/flysystem

```

Documentation
-------------

[](#documentation)

[Check out the documentation](https://flysystem.thephpleague.com/)

Community Integrations
----------------------

[](#community-integrations)

Want to get started quickly? Check out some of these integrations:

- Backup manager:
- CakePHP integration:
- Cilex integration:
- Drupal:
- elFinder:
- Laravel integration:
- Silex integration:
- Symfony integration:
- Yii 2 integration:
- Zend Framework integration:
- PSR-11 containers:

Adapters
--------

[](#adapters)

### Core

[](#core)

- Ftp
- Local
- NullAdapter

### Officially Supported

[](#officially-supported)

- Amazon Web Services - S3 V2:
- Amazon Web Services - S3 V3:
- Azure Blob Storage:
- Memory:
- PHPCR:
- Rackspace Cloud Files:
- Sftp (through phpseclib):
- WebDAV (through SabreDAV):
- Zip (through ZipArchive):

### Community Supported

[](#community-supported)

- AliYun OSS Storage:
- Amazon Cloud Drive -
- Azure File Storage:
- Backblaze:
- ClamAV Scanner Adapter:
- Citrix ShareFile:
- Cloudinary:
- Dropbox (with PHP 5.6 support):
- Dropbox:
- Fallback:
- Gaufrette:
- Google Cloud Storage:
- Google Drive:
- Google Drive V2 (using regular paths):
- OneDrive:
- OpenStack Swift:
- Redis (through Predis):
- Selectel Cloud Storage:
- SinaAppEngine Storage:
- PDO Database:

Caching ()
--------------------------------------------------------------------

[](#caching-httpsgithubcomthephpleagueflysystem-cached-adapter)

- Adapter (using another Flysystem adapter)
- Memcached
- Memory (array caching)
- Redis (through Predis)
- Stash

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

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 82.7% 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 ~16 days

Recently: every ~40 days

Total

113

Last Release

2769d ago

Major Versions

0.5.12 → 1.0.0-alpha12015-01-18

1.0.45 → 2.0.x-dev2018-08-22

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

1.0.29PHP &gt;=5.6.0

1.0.30PHP &gt;=5.5.9

2.0.x-devPHP &gt;=7.1.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/7acada59d92c957f4c54b66bf3be196489090dc119152940923fd05a680598c4?d=identicon)[mazpaijo](/maintainers/mazpaijo)

---

Top Contributors

[![frankdejonge](https://avatars.githubusercontent.com/u/534693?v=4)](https://github.com/frankdejonge "frankdejonge (1090 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (64 commits)")[![twistor](https://avatars.githubusercontent.com/u/42400?v=4)](https://github.com/twistor "twistor (43 commits)")[![TechAlchemistry](https://avatars.githubusercontent.com/u/4455837?v=4)](https://github.com/TechAlchemistry "TechAlchemistry (16 commits)")[![woodsae](https://avatars.githubusercontent.com/u/26761?v=4)](https://github.com/woodsae "woodsae (8 commits)")[![holtkamp](https://avatars.githubusercontent.com/u/776405?v=4)](https://github.com/holtkamp "holtkamp (7 commits)")[![K-Phoen](https://avatars.githubusercontent.com/u/66958?v=4)](https://github.com/K-Phoen "K-Phoen (7 commits)")[![basz](https://avatars.githubusercontent.com/u/143068?v=4)](https://github.com/basz "basz (6 commits)")[![duncan3dc](https://avatars.githubusercontent.com/u/546811?v=4)](https://github.com/duncan3dc "duncan3dc (6 commits)")[![4d47](https://avatars.githubusercontent.com/u/729919?v=4)](https://github.com/4d47 "4d47 (5 commits)")[![barryvdh](https://avatars.githubusercontent.com/u/973269?v=4)](https://github.com/barryvdh "barryvdh (5 commits)")[![cramiro](https://avatars.githubusercontent.com/u/432391?v=4)](https://github.com/cramiro "cramiro (5 commits)")[![creocoder](https://avatars.githubusercontent.com/u/896494?v=4)](https://github.com/creocoder "creocoder (5 commits)")[![WyriHaximus](https://avatars.githubusercontent.com/u/147145?v=4)](https://github.com/WyriHaximus "WyriHaximus (5 commits)")[![jeroenvdgulik](https://avatars.githubusercontent.com/u/242090?v=4)](https://github.com/jeroenvdgulik "jeroenvdgulik (4 commits)")[![hassankhan](https://avatars.githubusercontent.com/u/1781985?v=4)](https://github.com/hassankhan "hassankhan (4 commits)")[![romeOz](https://avatars.githubusercontent.com/u/3135712?v=4)](https://github.com/romeOz "romeOz (4 commits)")[![sparkweb](https://avatars.githubusercontent.com/u/1682258?v=4)](https://github.com/sparkweb "sparkweb (4 commits)")[![staabm](https://avatars.githubusercontent.com/u/120441?v=4)](https://github.com/staabm "staabm (4 commits)")[![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (3 commits)")

---

Tags

ftpfilesystemabstractions3awscloudsftpfilesstorageWebDAVfilesystemsremotedropboxrackspacecopy.comCloud Filesfile systems

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k639.1M2.2k](/packages/league-flysystem)[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)
