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

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

apollopy/flysystem-aliyun-oss
=============================

This is a Flysystem adapter for the Aliyun OSS ~2.3

1.2.1(6y ago)94128.2k↓35.5%22[2 issues](https://github.com/apollopy/flysystem-aliyun-oss/issues)3MITPHPPHP >=5.5.9CI failing

Since Jan 20Pushed 4mo ago3 watchersCompare

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

READMEChangelogDependencies (3)Versions (9)Used By (3)

Flysystem Adapter for Aliyun OSS.
=================================

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

This is a Flysystem adapter for the Aliyun OSS ~2.3

inspire by [aobozhang/aliyun-oss-adapter](https://github.com/aobozhang/aliyun-oss-adapter)

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

[](#installation)

```
composer require apollopy/flysystem-aliyun-oss
```

for Laravel
-----------

[](#for-laravel)

This service provider must be registered.

```
// config/app.php

'providers' => [
    '...',
    ApolloPY\Flysystem\AliyunOss\AliyunOssServiceProvider::class,
];
```

edit the config file: config/filesystems.php

add config

```
'oss' => [
    'driver'     => 'oss',
    'access_id'  => env('OSS_ACCESS_ID','your id'),
    'access_key' => env('OSS_ACCESS_KEY','your key'),
    'bucket'     => env('OSS_BUCKET','your bucket'),
    'endpoint'   => env('OSS_ENDPOINT','your endpoint'),
    'prefix'     => env('OSS_PREFIX', ''), // optional
],
```

change default to oss

```
    'default' => 'oss'
```

Use
---

[](#use)

see [Laravel wiki](https://laravel.com/docs/5.1/filesystem)

Plugins
-------

[](#plugins)

inspire by [itbdw/laravel-storage-qiniu](https://github.com/itbdw/laravel-storage-qiniu)

```
Storage::disk('oss')->putFile($md5_path, '/local_file_path/1.png', ['mimetype' => 'image/png','filename' => 'filename_by_down.png']);

Storage::disk('oss')->signedDownloadUrl($path, 3600, 'oss-cn-beijing.aliyuncs.com', true);
```

IDE Helper
----------

[](#ide-helper)

if installed [barryvdh/laravel-ide-helper](https://github.com/barryvdh/laravel-ide-helper)

edit the config file: config/ide-helper.php

```
'interfaces'      => [
    '\Illuminate\Contracts\Filesystem\Filesystem' => ApolloPY\Flysystem\AliyunOss\FilesystemAdapter::class,
],
```

###  Health Score

48

—

FairBetter than 93% of packages

Maintenance50

Moderate activity, may be stable

Popularity46

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 97.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 ~243 days

Recently: every ~363 days

Total

7

Last Release

2358d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2421282?v=4)[ApolloPY](/maintainers/apollopy)[@apollopy](https://github.com/apollopy)

---

Top Contributors

[![apollopy](https://avatars.githubusercontent.com/u/2421282?v=4)](https://github.com/apollopy "apollopy (35 commits)")[![baijunyao](https://avatars.githubusercontent.com/u/9360694?v=4)](https://github.com/baijunyao "baijunyao (1 commits)")

---

Tags

aliyun-ossflysystem-adapterlaravelphp

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.7k285.7M1.0k](/packages/league-flysystem-aws-s3-v3)[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.5M85](/packages/unisharp-laravel-filemanager)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[league/flysystem-bundle

Symfony bundle integrating Flysystem into Symfony applications

40432.5M137](/packages/league-flysystem-bundle)[iidestiny/flysystem-oss

Flysystem adapter for the Oss storage.

96640.6k29](/packages/iidestiny-flysystem-oss)

PHPackages © 2026

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