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

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

imnpc/laravel-flysystem-oss
===========================

This is a Flysystem adapter for the Aliyun OSS.

3.0.0(2mo ago)069MITPHPPHP ^8.0.2

Since Feb 19Pushed 2mo agoCompare

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

READMEChangelog (3)Dependencies (8)Versions (14)Used By (0)

Laravel-flysystem-oss
=====================

[](#laravel-flysystem-oss)

 [![Stable Version](https://camo.githubusercontent.com/6740ccc3e0116f1b6465a7c6175b00c2b29dd37989c32ec4ca3be61204666198/68747470733a2f2f706f7365722e707567782e6f72672f6c617276612f6c61726176656c2d666c7973797374656d2d6f73732f762f737461626c65)](https://packagist.org/packages/larva/laravel-flysystem-oss) [![Total Downloads](https://camo.githubusercontent.com/6e55bce34bf0e11538d732eeaa4d91239df994e7b4d1c5f67d2a1dd69088630b/68747470733a2f2f706f7365722e707567782e6f72672f6c617276612f6c61726176656c2d666c7973797374656d2d6f73732f646f776e6c6f616473)](https://packagist.org/packages/larva/laravel-flysystem-oss) [![License](https://camo.githubusercontent.com/75b69d936e33db796bda906554ab669f4ecb0efc0213be33a93409917afb01ea/68747470733a2f2f706f7365722e707567782e6f72672f6c617276612f6c61726176656c2d666c7973797374656d2d6f73732f6c6963656e7365)](https://packagist.org/packages/larva/laravel-flysystem-oss)

适用于 Laravel 的阿里云 OSS 适配器，完整支持阿里云 OSS 所有方法和操作。

安装
--

[](#安装)

```
composer require imnpc/laravel-flysystem-oss -vv
```

修改配置文件: `config/filesystems.php`

添加一个磁盘配置

```
    'oss' => [
        'driver' => 'oss',
        'access_id' => env('OSS_ACCESS_KEY_ID'),
        'access_key' => env('OSS_ACCESS_KEY_SECRET'),
        'bucket' => env('OSS_BUCKET'),
        'endpoint' => env('OSS_ENDPOINT'), // 不要用CName,经过测试，官方SDK实现不靠谱
        'url' => env('OSS_DOMAIN'), // CNAME 写这里，可以是域名绑定或者CDN地址 如 https://www.bbb.com 末尾不要斜杠
        'root' => env('OSS_ROOT', ''), // 这个文件路径前缀，如果上传的内容全部在子目录就填写，否则为空
        'security_token' => null,
        'proxy' => null,
        'timeout' => 3600,
        'ssl' => env('OSS_SSL', false),
    ],
```

在 .env 文件里面添加

```
# 阿里云 OSS
OSS_ACCESS_KEY_ID=
OSS_ACCESS_KEY_SECRET=
OSS_BUCKET=
OSS_ENDPOINT=
OSS_DOMAIN=
OSS_ROOT=
OSS_SSL=
```

修改默认存储驱动

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

使用
--

[](#使用)

参见 [Laravel wiki](https://laravel.com/docs/9.x/filesystem)

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance88

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 51.9% 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 ~154 days

Recently: every ~299 days

Total

13

Last Release

61d ago

Major Versions

1.0.3 → 2.0.02022-03-14

2.0.7 → 3.0.02026-03-12

PHP version history (5 changes)1.0.0PHP ^7.2

1.0.2PHP ^7.2 || ^8.0

1.0.3PHP ^7.4|^8.0

2.0.0PHP ^8.0

2.0.3PHP ^8.0.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/4f149dfb0fcbc9e73b835450b3b2bd4e1b732e0d2113f519705b22f95913acae?d=identicon)[imnpc](/maintainers/imnpc)

---

Top Contributors

[![xutongle](https://avatars.githubusercontent.com/u/46956076?v=4)](https://github.com/xutongle "xutongle (14 commits)")[![xutl](https://avatars.githubusercontent.com/u/20939388?v=4)](https://github.com/xutl "xutl (8 commits)")[![imnpc](https://avatars.githubusercontent.com/u/5801647?v=4)](https://github.com/imnpc "imnpc (5 commits)")

---

Tags

FlysystemaliyunossLarva

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

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

```
[![Health](https://phpackages.com/badges/imnpc-laravel-flysystem-oss/health.svg)](https://phpackages.com/packages/imnpc-laravel-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-sftp-v3

SFTP filesystem adapter for Flysystem.

6129.6M91](/packages/league-flysystem-sftp-v3)[alphasnow/aliyun-oss-flysystem

Flysystem adapter for the Aliyun storage

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

aliyun oss filesystem storage for laravel 9+

1529.9k1](/packages/luoyy-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)