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

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

yzh52521/flysystem-oss
======================

Aliyun OSS Adapter for Flysystem v3.0

v3.0.6(2y ago)212.2k[1 PRs](https://github.com/yzh52521/filesystem-oss/pulls)12MITPHPPHP ^8.0.2

Since Nov 3Pushed 2y ago1 watchersCompare

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

READMEChangelog (10)Dependencies (2)Versions (16)Used By (12)

Aliyun OSS Adapter For Flysystem.
---------------------------------

[](#aliyun-oss-adapter-for-flysystem)

AliYun OSS Storage adapter for flysystem - a PHP filesystem 3.0 abstraction.

Requirement
===========

[](#requirement)

- PHP >= 8.0

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

[](#installation)

composer require yzh52521/flysystem-oss 3.0

Usage
-----

[](#usage)

```
use League\Flysystem\Filesystem;
use yzh52521\Flysystem\Oss\OssAdapter;

$config = [
    "access_id" => "**************",             // Required, YourAccessKeyId
    "access_secret" => "********************",   // Required, YourAccessKeySecret
    "endpoint" => "oss-cn-shanghai.aliyuncs.com",// Required, Endpoint
    "bucket" => "bucket-name",                   // Required, Bucket
    "prefix" => "",
    'isCName'=> true, // 如果 isCname 为 false，endpoint 应配置 oss 提供的域名如：`oss-cn-beijing.aliyuncs.com`，cname 或 cdn 请自行到阿里 oss 后台配置并绑定 bucket
    'cdnUrl' =>''
    "options"=> [

    ]
];

$adapter = new OssAdapter($config);

// $adapter->setCdnUrl('https://cdn.xxx.com'); // 设置cdn url

$flysystem = new Filesystem($adapter);

$flysystem->write('file.md', 'contents');
$flysystem->writeStream('foo.md', fopen('file.md', 'r'));

$fileExists = $flysystem->fileExists('foo.md');
$flysystem->copy('foo.md', 'baz.md');
$flysystem->move('baz.md', 'bar.md');
$flysystem->delete('bar.md');
$has = $flysystem->has('bar.md');

$read = $flysystem->read('file.md');
$readStream = $flysystem->readStream('file.md');

$flysystem->createDirectory('foo/');
$directoryExists = $flysystem->directoryExists('foo/');
$flysystem->deleteDirectory('foo/');

$listContents = $flysystem->listContents('/', true);
$listPaths = [];
foreach ($listContents as $listContent) {
    $listPaths[] = $listContent->path();
}

$lastModified = $flysystem->lastModified('file.md');
$fileSize = $flysystem->fileSize('file.md');
$mimeType = $flysystem->mimeType('file.md');

$flysystem->setVisibility('file.md', 'private');
$visibility = $flysystem->visibility('file.md');

string $flysystem->getUrl('file.md');
```

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~44 days

Recently: every ~0 days

Total

15

Last Release

1043d ago

Major Versions

1.0 → 2.02021-11-03

1.x-dev → 3.02022-02-28

v2.0.1 → v3.0.12022-09-18

v2.0.2 → v3.0.62023-07-11

PHP version history (4 changes)1.0PHP >=5.6.0

2.0PHP >=7.2

3.0PHP ^8.0

v3.0.1PHP ^8.0.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/15060466?v=4)[听风吹雨](/maintainers/yuanzhihai)[@yuanzhihai](https://github.com/yuanzhihai)

---

Top Contributors

[![yuanzhihai](https://avatars.githubusercontent.com/u/15060466?v=4)](https://github.com/yuanzhihai "yuanzhihai (16 commits)")

---

Tags

filesystemadapteraliyunossaliyun-ossflysystem-ossflysystem3.0

### Embed Badge

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

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

###  Alternatives

[alphasnow/aliyun-oss-flysystem

Flysystem adapter for the Aliyun storage

14249.2k4](/packages/alphasnow-aliyun-oss-flysystem)[jacobcyl/ali-oss-storage

aliyun oss filesystem storage for laravel 5+

523566.2k7](/packages/jacobcyl-ali-oss-storage)[luoyy/ali-oss-storage

aliyun oss filesystem storage for laravel 9+

1529.9k1](/packages/luoyy-ali-oss-storage)[summergeorge/ali-oss-storage

aliyun oss filesystem storage for laravel 5+

3915.5k](/packages/summergeorge-ali-oss-storage)[aobozhang/aliyun-oss-adapter

Use Aliyun oss as Storage for Laravel 5.0+

141.0k](/packages/aobozhang-aliyun-oss-adapter)

PHPackages © 2026

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