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

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

larva/laravel-flysystem-oss
===========================

This is a Flysystem adapter for the Aliyun OSS.

2.0.5(3y ago)62.6k1[1 issues](https://github.com/larvatecn/laravel-flysystem-oss/issues)MITPHPPHP ^8.0.2

Since Feb 19Pushed 3y agoCompare

[ Source](https://github.com/larvatecn/laravel-flysystem-oss)[ Packagist](https://packagist.org/packages/larva/laravel-flysystem-oss)[ RSS](/packages/larva-laravel-flysystem-oss/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (10)Dependencies (4)Versions (11)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 larva/laravel-flysystem-oss -vv
```

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

添加一个磁盘配置

```
'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'),//不要用CName,经过测试，官方SDK实现不靠谱
    'url' => env('OSS_URL','cdn url'),//CNAME 写这里，可以是域名绑定或者CDN地址 如 https://www.bbb.com 末尾不要斜杠
    'root' => env('OSS_ROOT', ''), // 这个文件路径前缀，如果上传的内容全部在子目录就填写，否则为空
    'security_token' => null,
    'proxy' => null,
    'timeout' => 3600,
    'ssl' => true
],
```

修改默认存储驱动

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

使用
--

[](#使用)

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

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 63.6% 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 ~83 days

Recently: every ~89 days

Total

10

Last Release

1204d ago

Major Versions

1.0.3 → 2.0.02022-03-14

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/534cdb651e8c806590fa945c6b5a18f361613848e890db1349f4a9fbcae1a650?d=identicon)[xutongle](/maintainers/xutongle)

---

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)")

---

Tags

aliyunlaravelphpFlysystemaliyunossLarva

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

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

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

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.7k277.8M961](/packages/league-flysystem-aws-s3-v3)[alphasnow/aliyun-oss-flysystem

Flysystem adapter for the Aliyun storage

14270.2k8](/packages/alphasnow-aliyun-oss-flysystem)[luoyy/ali-oss-storage

aliyun oss filesystem storage for laravel 10+

1430.7k1](/packages/luoyy-ali-oss-storage)

PHPackages © 2026

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