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

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

calchen/flysystem-aliyun-oss
============================

用于阿里云对象存储（OSS）的 Flysystem Adapter（Flysystem Adapter for Aliyun OSS）

1.3.3(5y ago)71.2k2MITPHPPHP >=5.5.9

Since Aug 16Pushed 5y ago1 watchersCompare

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

READMEChangelog (8)Dependencies (2)Versions (13)Used By (0)

 flysystem-aliyun-oss
======================

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

 用于阿里云对象存储（OSS）的 Flysystem 适配器

 [ ![Style CI](https://camo.githubusercontent.com/46a7ce68de94834c9475db904f10e522bc485287202ef501035206d880dbea29/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3230323735353033342f736869656c643f7374796c653d666c6174) ](https://github.styleci.io/repos/202755034) [ ![Latest Stable Version](https://camo.githubusercontent.com/5550da194ad958073ebd3a2320f4a2442bf3df3633763163f9b715c099f208f8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f63616c6368656e2f666c7973797374656d2d616c6979756e2d6f73732e737667) ](https://packagist.org/packages/calchen/flysystem-aliyun-oss) [ ![Total Downloads](https://camo.githubusercontent.com/0a9761cba7058e4c893991e46c7a0f1a1dff88d71db4bd8a2a0f22716ebda006/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f63616c6368656e2f666c7973797374656d2d616c6979756e2d6f73732e737667) ](https://packagist.org/packages/calchen/flysystem-aliyun-oss) [ ![License](https://camo.githubusercontent.com/0711c4f9aabde895a6abe6185f72dcd741d5c108b0d3a846836e26893e0c486c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63616c6368656e2f666c7973797374656d2d616c6979756e2d6f73732e737667) ](https://github.com/calchen/flysystem-aliyun-oss/blob/master/LICENSE)

> [English](https://github.com/calchen/flysystem-aliyun-oss/blob/master/README_en.md)

这是一个基于阿里云 OSS SDK（2.3.0 及以上）的 Flysystem 适配器

受到 [apollopy/flysystem-aliyun-oss](https://github.com/apollopy/flysystem-aliyun-oss) 的启发

安装
--

[](#安装)

```
$ composer require calchen/flysystem-aliyun-oss
```

### Laravel

[](#laravel)

如果您的 Laravel 版本为 5.5 及以上，您不需要手动的配置文件中添加 `AliyunOssServiceProvider` Laravel 自带的扩展包发现机制会处理好一切。如是小于 5.5 版本那么需要您进行如下操作:

打开位于 `app/Providers` 的 `AppServiceProvider.php` 文件并在 `register` 函数中添加如下内容：

```
$this->app->register(\Calchen\Flysystem\AliyunOss\AliyunOssServiceProvider::class);
```

您也可以在配置文件 `config/app.php` 中的 `providers` 中添加如下内容：

```
Calchen\Flysystem\AliyunOss\AliyunOssServiceProvider::class,
```

只需选择以上操作中的一种，即可加载本扩招包。

### Lumen

[](#lumen)

Lumen 并未移植扩展包自动发现机制，所以需要手动加载扩展包并复制配置文件。

打开配置文件 `bootstrap/app.php` 并在大约 81 行左右添加如下内容：

```
$app->register(Calchen\Flysystem\AliyunOss\AliyunOssServiceProvider::class);
```

将文件系统配置文件从 `vendor/laravel/lumen-framework/filesystems.php` 复制到 `config/filesystems.php`

配置
--

[](#配置)

打开配置文件 `config/filesystems.php` 并在 `disks` 中添加如下内容：

```
'oss' => [
    'driver' => 'oss',
    'access_id' => env('ALIYUN_ACCESS_KEY_ID'),
    'access_key_secret' => env('ALIYUN_ACCESS_KEY_SECRET'),
    'bucket' => env('ALIYUN_OSS_BUCKET'),
    'endpoint' => env('ALIYUN_OSS_ENDPOINT'),
    'cdn_base_url' => env('ALIYUN_OSS_CDN_BASE_URL'),  // 可选
    'prefix' => '',                                    // 可选
],
```

如果您想将阿里云 OSS 作为默认的存储方式，那么可以在 `.env` 文件中设置配置项 `FILESYSTEM_DRIVER=oss`

### 配置说明

[](#配置说明)

配置项必须说明备注driver是驱动名称默认值：oss，不可修改access\_id是用于身份验证的 AccessKey ID见下文“安全提醒”access\_key\_secret是用于身份验证的 AccessKey Key Secret见下文“安全提醒”bucket是存储空间名称-endpoint是地域节点见下文“地域节点”cdn\_base\_url否CDN 基础路径见下文“CDN 基础路径”prefix否保存路径的统一前缀-#### 地域节点（endpoint）

[](#地域节点endpoint)

官方地域节点：[访问域名和数据中心](https://help.aliyun.com/document_detail/31837.html)

地域节点可以是域名，也可以是以 `http://域名` 或 `https://域名`。

如果地域节点是域名则默认使用 HTTPS，如果需要使用 HTTP 请使用 `http://域名`

#### 用户域名（CNAME domain）

[](#用户域名cname-domain)

设置成功并正常解析至阿里云 OSS 访问域名的用户域名可作为地域节点使用，如果是解析到 CDN 节点的用户域名是不可以作为地域节点使用的！！！

#### CDN 基础路径（CDN base URL）

[](#cdn-基础路径cdn-base-url)

如果您为阿里云 OSS 存储空间启用了 CDN（无论是不是阿里云 CDN），那么建议您设置 cdn\_base\_url，设置此项后您获取到的文件 URL 将全部以 cdn\_base\_url 开头

#### 安全提醒

[](#安全提醒)

为了安全，请使用子账户的 AccessKey ID 和 AccessKey Key Secret，请务必不要使用主账户的 AccessKey ID 和 AccessKey Key Secret

用法
--

[](#用法)

在 Laravel/Lumen 中可以使用 `\Storage::disk('oss')->temporaryUrl($filePath);` 来获取阿里云 OSS 私有存储空间中文件的带签名的 URL

开源协议
----

[](#开源协议)

[MIT](http://opensource.org/licenses/MIT)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity60

Established project with proven stability

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

Recently: every ~74 days

Total

12

Last Release

1933d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/817a37d0a77c2cd34160f84728e75171c7d8a4c6ac9621eaeaa611ca4d720ea9?d=identicon)[calchen](/maintainers/calchen)

---

Top Contributors

[![calchen](https://avatars.githubusercontent.com/u/3085383?v=4)](https://github.com/calchen "calchen (24 commits)")

---

Tags

laravellumenaliyunossObject Storage Service

### Embed Badge

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

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

###  Alternatives

[jacobcyl/ali-oss-storage

aliyun oss filesystem storage for laravel 5+

523566.2k7](/packages/jacobcyl-ali-oss-storage)[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)