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

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

illusionist/flysystem-aliyun-oss
================================

Flysystem adapter for the Aliyun OSS SDK

1.0.1(4y ago)11.3kMITPHPPHP >=5.5.9

Since Feb 24Pushed 4y ago1 watchersCompare

[ Source](https://github.com/illusionist-php/flysystem-aliyun-oss)[ Packagist](https://packagist.org/packages/illusionist/flysystem-aliyun-oss)[ RSS](/packages/illusionist-flysystem-aliyun-oss/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (4)Versions (4)Used By (0)

Illusionist Flysystem Aliyun OSS
================================

[](#illusionist-flysystem-aliyun-oss)

Flysystem adapter for the Aliyun OSS SDK

[![packagist](https://camo.githubusercontent.com/46441f8fdb3da42f467ed9503827a386944a31927e2bcb79acaf2d6b2f1b0bfc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696c6c7573696f6e6973742f666c7973797374656d2d616c6979756e2d6f73733f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/46441f8fdb3da42f467ed9503827a386944a31927e2bcb79acaf2d6b2f1b0bfc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696c6c7573696f6e6973742f666c7973797374656d2d616c6979756e2d6f73733f7374796c653d666c61742d737175617265)[![php](https://camo.githubusercontent.com/a122698d40f4083c898dbdf56be7023ce5e5a6a2f41d33031d3a0b36936ef234/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f696c6c7573696f6e6973742f666c7973797374656d2d616c6979756e2d6f73733f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/a122698d40f4083c898dbdf56be7023ce5e5a6a2f41d33031d3a0b36936ef234/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f696c6c7573696f6e6973742f666c7973797374656d2d616c6979756e2d6f73733f7374796c653d666c61742d737175617265)[![downloads](https://camo.githubusercontent.com/46f5ee552b7e0b0a020cbb711c380ef69c55bd1af63fc41330703baa9af4ee4e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f696c6c7573696f6e6973742f666c7973797374656d2d616c6979756e2d6f73733f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/46f5ee552b7e0b0a020cbb711c380ef69c55bd1af63fc41330703baa9af4ee4e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f696c6c7573696f6e6973742f666c7973797374656d2d616c6979756e2d6f73733f7374796c653d666c61742d737175617265)[![license](https://camo.githubusercontent.com/b2f3d0e1f032e981fc18c1b4a600bcd87b11e7567f0ac7def1b324c9d7fb7b9d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f696c6c7573696f6e6973742f666c7973797374656d2d616c6979756e2d6f73733f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/b2f3d0e1f032e981fc18c1b4a600bcd87b11e7567f0ac7def1b324c9d7fb7b9d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f696c6c7573696f6e6973742f666c7973797374656d2d616c6979756e2d6f73733f7374796c653d666c61742d737175617265)[![Build Status](https://camo.githubusercontent.com/95728eb85d8890c01b248675e40dd21a54f163fdc498167e39acc7eabe714b29/68747470733a2f2f6170702e7472617669732d63692e636f6d2f696c6c7573696f6e6973742d7068702f666c7973797374656d2d616c6979756e2d6f73732e7376673f6272616e63683d312e78)](https://app.travis-ci.com/illusionist-php/flysystem-aliyun-oss)

English | [中文](README-zh_CN.md)

Advantages
----------

[](#advantages)

1. Support Laravel & Lumen
2. Compared with [xxtime/flysystem-aliyun-oss](https://github.com/xxtime/flysystem-aliyun-oss), it is more in line with the [flysystem](https://flysystem.thephpleague.com/docs/architecture/) interface specification. Because the flysystem interface suggests that the return value is array or bool, but [xxtime/flysystem-aliyun-oss](https://github.com/xxtime/flysystem-aliyun-oss) is not very strict about exception handling.
3. Compared to [apollopy/flysystem-aliyun-oss <= 1.2.0](https://github.com/apollopy/flysystem-aliyun-oss) supports visibility get/set.
4. Support Dynamically call OSS SDK methods.

**ps:** The comparison of similar projects is only to highlight the differences. In fact, they are all very good.

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

[](#installation)

#### Install via composer

[](#install-via-composer)

Run the following command to pull in the latest version:

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

#### Laravel Install

[](#laravel-install)

If your laravel version ` [

    ...

    Illusionist\Flysystem\Aliyun\OssServiceProvider::class,
]
```

##### Lumen Install

[](#lumen-install)

Add the following snippet to the `bootstrap/app.php` file under the providers section as follows:

```
...

// Add this line
$app->register(Illusionist\Flysystem\Aliyun\OssServiceProvider::class);
```

##### Config for Laravel/Lumen

[](#config-for-laravellumen)

Add the adapter config to the `disks` array in the `config/filesystems.php` config file as follows:

```
'disks' => [
    ...

    'aliyun-oss' => [

        'driver' => 'aliyun-oss',

        /**
         * The AccessKeyId from OSS or STS.
         */
        'key' => '',

        /**
         * The AccessKeySecret from OSS or STS
         */
        'secret' => '',

        /**
         * The domain name of the datacenter.
         *
         * @example: oss-cn-hangzhou.aliyuncs.com
         */
        'endpoint' => '',

        /**
         * The bucket name for the OSS.
         */
        'bucket' => '',

        /**
         * The security token from STS.
         */
        'token' => null,

        /**
         * If this is the CName and binded in the bucket.
         *
         * Values: true or false
         */
        'cname' => false,

        /**
         * Path prefix
         */
        'prefix' => '',

        /**
         *  Request header options.
         *
         *  @example [x-oss-server-side-encryption => 'KMS']
         */
        'options' => []
    ]
]
```

Usage
-----

[](#usage)

##### Basic

[](#basic)

Please refer to [filesystem-api](https://flysystem.thephpleague.com/docs/usage/filesystem-api/).

```
use Illusionist\Flysystem\Aliyun\OssAdapter;
use League\Flysystem\Filesystem;
use OSS\OssClient;

$client = new OssClient(
    '',
    '',
    ''
);

$adapter = new OssAdapter($client, '', 'optional-prefix', 'optional-options');
$filesystem = new Filesystem($adapter);

$filesystem->has('file.txt');

// Dynamic call SDK method.
$adapter->setTimeout(30);
$filesystem->getAdapter()->setTimeout(30);
```

##### Laravel/Lumen

[](#laravellumen)

Please refer to [filesystem](https://laravel.com/docs/6.x/filesystem)

```
use Illuminate\Support\Facades\Storage;

Storage::disk('aliyun-oss')->get('path');

// Dynamic call SDK method.
Storage::disk('aliyun-oss')->getAdapter()->setTimeout(30);
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 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 ~0 days

Total

3

Last Release

1538d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/54e002767d78036837d5bd9fee6f8b2d0261fd3783d75c34a5589f4674b25974?d=identicon)[kayson](/maintainers/kayson)

---

Top Contributors

[![kaysonwu](https://avatars.githubusercontent.com/u/14865584?v=4)](https://github.com/kaysonwu "kaysonwu (6 commits)")

---

Tags

filesystemlaravellumenaliyun-oss

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[jerodev/flysystem-v3-smb-adapter

SMB adapter for Flysystem v3

1289.9k1](/packages/jerodev-flysystem-v3-smb-adapter)[yoelpc4/laravel-cloudinary

Laravel Cloudinary filesystem cloud driver.

3343.0k](/packages/yoelpc4-laravel-cloudinary)

PHPackages © 2026

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