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

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

gasparyanyur/flysystem
======================

Filesystem abstraction: Many filesystems, one API.

1.0.40(9y ago)016MITPHPPHP &gt;=5.5.9

Since Oct 28Pushed 8y agoCompare

[ Source](https://github.com/gasparyanyur/flysystem)[ Packagist](https://packagist.org/packages/gasparyanyur/flysystem)[ RSS](/packages/gasparyanyur-flysystem/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (3)Versions (106)Used By (0)

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

[](#leagueflysystem)

[![Author](https://camo.githubusercontent.com/bf87237874a25aebcf58b7f23dfdeb9098e58b5c011ca83aed2b6e519a392d84/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d406672616e6b64656a6f6e67652d626c75652e7376673f7374796c653d666c61742d737175617265)](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/d139ed1acae4a5eed42e3a24aafbe2daa78099ccb37e20723e47b43af46ebe9a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c65616775652f666c7973797374656d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/league/flysystem)[![Total Downloads](https://camo.githubusercontent.com/9b8fe990202aef5acede08b8283e085a42ff5bae096dbdca0c97e24790596ba9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c65616775652f666c7973797374656d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/league/flysystem)

[![SensioLabsInsight](https://camo.githubusercontent.com/5640bdd93950301bbc5065b4070f89a136cfbed664061bb317d537f6d8b8a8b5/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f39383230663161662d326664302d346162362d623432612d3033653063383231653061662f6269672e706e67)](https://insight.sensiolabs.com/projects/9820f1af-2fd0-4ab6-b42a-03e0c821e0af)[![Build status](https://camo.githubusercontent.com/22690ea2b166574447d353f704251a9edba53a5276f9175890a5b71e1d80aa4f/68747470733a2f2f63692e6170707665796f722e636f6d2f6170692f70726f6a656374732f7374617475732f6f6f64647164747072706e6a796167792f6272616e63682f6d61737465723f7376673d74727565)](https://ci.appveyor.com/project/frankdejonge/flysystem/branch/master)

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

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 support none, like AwsS3.
- Support third party plugins.
- Make it easy to test your filesystem interactions.
- Support streams for big file handling.

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

[](#installation)

Through Composer, obviously:

```
composer require league/flysystem

```

You can also use Flysystem without using Composer by registering an autoloader function:

```
spl_autoload_register(function($class) {
    $prefix = 'League\\Flysystem\\';

    if (substr($class, 0, 17) !== $prefix) {
        return;
    }

    $class = substr($class, strlen($prefix));
    $location = __DIR__ . 'path/to/flysystem/src/' . str_replace('\\', '/', $class) . '.php';

    if (is_file($location)) {
        require_once($location);
    }
});
```

Integrations
------------

[](#integrations)

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

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

Adapters
--------

[](#adapters)

- Local
- Amazon Web Services - S3 V2:
- Amazon Web Services - S3 V3:
- Amazon Cloud Drive -
- Rackspace Cloud Files:
- Dropbox:
- Dropbox API v2 (with PHP 5.6 support):
- OneDrive:
- Ftp
- Sftp (through phpseclib):
- Zip (through ZipArchive):
- WebDAV (through SabreDAV):
- PHPCR:
- Azure Blob Storage
- NullAdapter
- Redis (through Predis):
- Fallback:
- Memory:
- Google Cloud Storage:
- SinaAppEngine Storage:
- Gaufrette:
- OpenStack Swift:
- Google Drive:
- Backblaze:
- Selectel Cloud Storage:

Caching
-------

[](#caching)

- Memory (array caching)
- Redis (through Predis)
- Memcached
- Adapter
- Stash

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

[](#documentation)

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

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](http://twitter.com/frankdejonge).

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 82.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 ~12 days

Total

104

Last Release

3350d ago

Major Versions

0.5.12 → 1.0.0-alpha12015-01-18

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

1.0.29PHP &gt;=5.6.0

1.0.30PHP &gt;=5.5.9

### Community

Maintainers

![](https://www.gravatar.com/avatar/7935254d77a9d38e1aff240f650e5c14079ec67b06fbe57947991639e2cc612f?d=identicon)[gasparyanyur](/maintainers/gasparyanyur)

---

Top Contributors

[![frankdejonge](https://avatars.githubusercontent.com/u/534693?v=4)](https://github.com/frankdejonge "frankdejonge (940 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 (25 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)")[![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)")[![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)")[![duncan3dc](https://avatars.githubusercontent.com/u/546811?v=4)](https://github.com/duncan3dc "duncan3dc (5 commits)")[![WyriHaximus](https://avatars.githubusercontent.com/u/147145?v=4)](https://github.com/WyriHaximus "WyriHaximus (5 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)")[![romeOz](https://avatars.githubusercontent.com/u/3135712?v=4)](https://github.com/romeOz "romeOz (4 commits)")[![hassankhan](https://avatars.githubusercontent.com/u/1781985?v=4)](https://github.com/hassankhan "hassankhan (4 commits)")[![jeroenvdgulik](https://avatars.githubusercontent.com/u/242090?v=4)](https://github.com/jeroenvdgulik "jeroenvdgulik (4 commits)")[![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (3 commits)")[![kristianedlund](https://avatars.githubusercontent.com/u/1947488?v=4)](https://github.com/kristianedlund "kristianedlund (3 commits)")

---

Tags

ftpfilesystemabstractions3awscloudsftpfilesstorageWebDAVfilesystemsremotedropboxrackspacecopy.comCloud Filesfile systems

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k665.7M2.4k](/packages/league-flysystem)[verseles/flyclone

PHP wrapper for rclone

102.2k](/packages/verseles-flyclone)[creocoder/yii2-flysystem

The flysystem extension for the Yii framework

2861.7M63](/packages/creocoder-yii2-flysystem)

PHPackages © 2026

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