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

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

zing/flysystem-oss
==================

OSS filesystem adapter for Flysystem.

3.2.1(1y ago)320.1k—2.6%[1 PRs](https://github.com/zingimmick/flysystem-oss/pulls)2MITPHPPHP ^8.0CI passing

Since Jan 19Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/zingimmick/flysystem-oss)[ Packagist](https://packagist.org/packages/zing/flysystem-oss)[ Docs](https://github.com/zingimmick/flysystem-oss)[ Fund](https://www.paypal.com/paypalme/zingimmick)[ RSS](/packages/zing-flysystem-oss/feed)WikiDiscussions 3.x Synced 1mo ago

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

Flysystem OSS
=============

[](#flysystem-oss)

[![tests](https://github.com/zingimmick/flysystem-oss/actions/workflows/tests.yml/badge.svg?branch=3.x)](https://github.com/zingimmick/flysystem-oss/actions/workflows/tests.yml)[![Code Coverage](https://camo.githubusercontent.com/39c7d89d08eed888429b34ce287abbe54b93233bf401051df8f23a4cc89dd9d7/68747470733a2f2f636f6465636f762e696f2f67682f7a696e67696d6d69636b2f666c7973797374656d2d6f73732f6272616e63682f332e782f67726170682f62616467652e737667)](https://codecov.io/gh/zingimmick/flysystem-oss)[![Latest Stable Version](https://camo.githubusercontent.com/49491461a989e50b01fa4d247526bf90dfe7e9fdaa1a03e9d918b7d9833673be/68747470733a2f2f706f7365722e707567782e6f72672f7a696e672f666c7973797374656d2d6f73732f762f737461626c652e737667)](https://packagist.org/packages/zing/flysystem-oss)[![Total Downloads](https://camo.githubusercontent.com/72e8c9c5cb7e96f657be13e741eab35887c723ba9f09ced85dad0c709de355ff/68747470733a2f2f706f7365722e707567782e6f72672f7a696e672f666c7973797374656d2d6f73732f646f776e6c6f616473)](https://packagist.org/packages/zing/flysystem-oss)[![Latest Unstable Version](https://camo.githubusercontent.com/17b3ec93ce0331ac7bce3e6274fd7a0706dd7d4a7803ab4b0bf27a7d090fed2b/68747470733a2f2f706f7365722e707567782e6f72672f7a696e672f666c7973797374656d2d6f73732f762f756e737461626c652e737667)](https://packagist.org/packages/zing/flysystem-oss)[![License](https://camo.githubusercontent.com/43c4ce74c92c19e99b9457a06ed96c5c5d7d13c2e8d75a1d668add576208390e/68747470733a2f2f706f7365722e707567782e6f72672f7a696e672f666c7973797374656d2d6f73732f6c6963656e7365)](https://packagist.org/packages/zing/flysystem-oss)

> **Requires**
>
> - **[PHP 8.0+](https://php.net/releases/)**
> - **[Flysystem 3.10+](https://github.com/thephpleague/flysystem/releases)**

Version Information
-------------------

[](#version-information)

VersionFlysystemPHP VersionStatus3.x3.10+>= 8.0Active support 🚀2.x2.x - 3.x>= 7.2Active support1.x1.x>= 7.2Active supportRequire Flysystem OSS using [Composer](https://getcomposer.org):

```
composer require zing/flysystem-oss
```

Usage
-----

[](#usage)

```
use League\Flysystem\Filesystem;
use OSS\OssClient;
use Zing\Flysystem\Oss\OssAdapter;

$prefix = '';
$config = [
    'provider' => new StaticCredentialsProvider('aW52YWxpZC1rZXk=', 'aW52YWxpZC1zZWNyZXQ='),
    'bucket' => 'test',
    'endpoint' => 'oss-cn-shanghai.aliyuncs.com',
];

$config['options'] = [
    'url' => '',
    'endpoint' => $config['endpoint'],
    'bucket_endpoint' => '',
    'temporary_url' => '',
];

$client = new OssClient($config);
$adapter = new OssAdapter($client, $config['bucket'], $prefix, null, null, $config['options']);
$flysystem = new Filesystem($adapter);
```

Integration
-----------

[](#integration)

- Laravel: [zing/laravel-flysystem-oss](https://github.com/zingimmick/laravel-flysystem-oss)

Reference
---------

[](#reference)

[league/flysystem-aws-s3-v3](https://github.com/thephpleague/flysystem-aws-s3-v3)

License
-------

[](#license)

Flysystem OSS is an open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance68

Regular maintenance activity

Popularity29

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 56.8% 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 ~63 days

Recently: every ~214 days

Total

25

Last Release

53d ago

Major Versions

1.4.0 → 2.2.02022-03-14

1.4.1 → 2.2.12022-03-21

1.5.0 → 2.3.02022-08-20

2.x-dev → 3.0.02022-10-26

1.x-dev → 3.2.12025-01-22

PHP version history (2 changes)2.0.0-beta.1PHP ^7.2 || ^8.0

3.0.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/5fafa5bffa28dcd722432b244bf3f0bfe773406df29fea295847e2397b95d50b?d=identicon)[zingimmick](/maintainers/zingimmick)

---

Top Contributors

[![zingimmick](https://avatars.githubusercontent.com/u/26657141?v=4)](https://github.com/zingimmick "zingimmick (96 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (69 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (4 commits)")

---

Tags

filesystemflysystemossfilesystemFlysystemfilefilesstorageoss

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

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

Local filesystem adapter for Flysystem.

226231.8M39](/packages/league-flysystem-local)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6129.6M91](/packages/league-flysystem-sftp-v3)[league/flysystem-async-aws-s3

AsyncAws S3 filesystem adapter for Flysystem.

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

In-memory filesystem adapter for Flysystem.

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

FTP filesystem adapter for Flysystem.

2820.8M101](/packages/league-flysystem-ftp)

PHPackages © 2026

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