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

ActiveLibrary

hobbily/flysystem-aliyun-oss
============================

This is a Flysystem adapter for the Aliyun OSS ~2.2.1

3.0.1(8y ago)025MITPHPPHP >=5.5.9

Since Jan 20Pushed 8y ago1 watchersCompare

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

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

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

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

This is a Flysystem adapter for the Aliyun OSS ~2.2.1

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

inspire by [apollopy/flysystem-aliyun-oss](https://github.com/apollopy/flysystem-aliyun-oss)

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

[](#installation)

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

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

[](#for-laravel)

This service provider must be registered.

In order to be compatible to prev `xsilen/flysystem-aliyun-oss`, i have not change namespace start with `Gradii`

```
// config/app.php

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

edit the config file: config/filesystems.php

add config

```
'oss' => [
    'driver'     => 'oss',
    'access_id'  => env('ALIYUN_OSS_ACCESS_KEY_ID'),
    'access_key' => env('ALIYUN_OSS_ACCESS_KEY_SECRET'),
    'bucket'     => env('ALIYUN_OSS_BUCKET_NAME'),
    //使用endpoint来上传oss文件, 如果是OSS内网上传, 刚将OSS内网地址填在此处
    'endpoint'   => env('ALIYUN_OSS_ENDPOINT'),
    'cdnDomain'  => env('ALIYUN_OSS_CDN_DOMAIN'),
    // true to use 'https://' and false to use 'http://'. default is false,
    'ssl'        => true,
    // 如果isCName为true, getUrl会判断cdnDomain是否设定来决定返回的url，如果cdnDomain未设置，则使用endpoint来生成url，否则使用cdn
    // 而且, 上传将会用endpoint来上传, 读取将会用cdnDomain来读取
    'isCName'    => true,
    '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($path, '/local_file_path/1.png', ['mimetype' => 'image/png']);
Storage::disk('oss')->signedDownloadUrl($path, 3600, /*可强制写cdnDomain*/'oss-cn-beijing.aliyuncs.com', true);
Storage::disk('oss')->fullUrl($path, /*可强制写cdnDomain*/'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' => Xsilen\Flysystem\AliyunOss\FilesystemAdapter::class,
],
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 61.5% 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 ~61 days

Recently: every ~22 days

Total

11

Last Release

3152d ago

Major Versions

1.3 → 2.0.02017-07-19

2.0.1.x-dev → 3.0.12017-09-26

### Community

Maintainers

![](https://www.gravatar.com/avatar/1c156a73dc54040adbac89666623f638249e35dde32afe0548a6c93b326b0d1e?d=identicon)[hobbily](/maintainers/hobbily)

---

Top Contributors

[![apollopy](https://avatars.githubusercontent.com/u/2421282?v=4)](https://github.com/apollopy "apollopy (32 commits)")[![xsilen-tt](https://avatars.githubusercontent.com/u/90232688?v=4)](https://github.com/xsilen-tt "xsilen-tt (19 commits)")[![hobbily](https://avatars.githubusercontent.com/u/4475757?v=4)](https://github.com/hobbily "hobbily (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[laravel/framework

The Laravel Framework.

34.6k509.9M17.0k](/packages/laravel-framework)[spatie/laravel-backup

A Laravel package to backup your application

6.0k21.8M191](/packages/spatie-laravel-backup)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

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

Generate API documentation for humans from your Laravel codebase.✍

2.3k12.2M45](/packages/knuckleswtf-scribe)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[unisharp/laravel-filemanager

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

2.2k3.3M74](/packages/unisharp-laravel-filemanager)

PHPackages © 2026

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