PHPackages                             fly3949/flysystem-upyun - 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 &amp; Storage](/categories/file-storage)
4. /
5. fly3949/flysystem-upyun

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

fly3949/flysystem-upyun
=======================

Flysystem and Laravel adapter for the Upyun storage.

1.1.0(5y ago)09MITPHPPHP &gt;=5.5.9

Since May 4Pushed 5y agoCompare

[ Source](https://github.com/fly3949/flysystem-upyun)[ Packagist](https://packagist.org/packages/fly3949/flysystem-upyun)[ RSS](/packages/fly3949-flysystem-upyun/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (3)Versions (7)Used By (0)

Laravel Flysystem Upyun (又拍云)
=============================

[](#laravel-flysystem-upyun-又拍云)

💾 又拍云 Flysystem 实现，可直接用于 Laravel 项目。

[![Build Status](https://camo.githubusercontent.com/37a5a59bd7f8e97c0e786dabcf3300e7f1821b34cd57ee0dba1b24f6888dd583/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f4a656c6c79426f6f6c2f666c7973797374656d2d757079756e2f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/JellyBool/flysystem-upyun/build-status/master)[![Quality Score](https://camo.githubusercontent.com/1564c1947b8692afbe0a66794901f3d1fca1cc702a78dc0cfbdee416d5c537c0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f4a656c6c79426f6f6c2f666c7973797374656d2d757079756e2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/JellyBool/flysystem-upyun/build-status/master)[![Latest Stable Version](https://camo.githubusercontent.com/6aa037bcd7c336cfefa8d5a024cc69b26f13f3583a4d52e529bebb17b189262c/68747470733a2f2f706f7365722e707567782e6f72672f4a656c6c79426f6f6c2f666c7973797374656d2d757079756e2f762f737461626c652e737667)](https://packagist.org/packages/JellyBool/flysystem-upyun)[![Latest Unstable Version](https://camo.githubusercontent.com/98b9230132a1a5058d0e261cf6ed0bc808986c61811bfa90432296221bd5171a/68747470733a2f2f706f7365722e707567782e6f72672f4a656c6c79426f6f6c2f666c7973797374656d2d757079756e2f762f756e737461626c652e737667)](https://packagist.org/packages/JellyBool/flysystem-upyun)[![Total Downloads](https://camo.githubusercontent.com/4faab2d4905ba1405cb58303aae737c6505b47fbc545b19877293c2e8a4938c5/68747470733a2f2f706f7365722e707567782e6f72672f4a656c6c79426f6f6c2f666c7973797374656d2d757079756e2f646f776e6c6f616473)](https://packagist.org/packages/JellyBool/flysystem-upyun)[![License](https://camo.githubusercontent.com/6c0ac840258a202bf693663546f5f5d93a7d5b53ec27e83e45d838295c58e86b/68747470733a2f2f706f7365722e707567782e6f72672f4a656c6c79426f6f6c2f666c7973797374656d2d757079756e2f6c6963656e7365)](https://packagist.org/packages/JellyBool/flysystem-upyun)

Requirement
===========

[](#requirement)

- PHP &gt;= 5.5.9

视频教程
====

[](#视频教程)

> 视频使用教程(当然是免费的)：

安装
==

[](#安装)

直接可以通过 composer 来安装:

```
$ composer require "jellybool/flysystem-upyun"
```

使用
==

[](#使用)

1.在一般项目中使用
----------

[](#1在一般项目中使用)

```
use League\Flysystem\Filesystem;
use JellyBool\Flysystem\Upyun\UpyunAdapter;

$bucket = 'your-bucket-name';
$operator = 'oparator-name';
$password = 'operator-password';
$domain = 'xxxxx.b0.upaiyun.com'; // 或者 https://xxxx.b0.upaiyun.com

$adapter = new UpyunAdapter($bucket, $operator, $password, $domain);

$flysystem = new Filesystem($adapter);
```

2.在 Laravel 中使用
---------------

[](#2在-laravel-中使用)

1.在 `config/app.php` 添加 `UpyunServiceProvider`:

```
'providers' => [
    // Other service providers...
    JellyBool\Flysystem\Upyun\UpyunServiceProvider::class,
],
```

2.在 `config/filesystems.php` 的 `disks` 中添加下面的配置：

```
return [
    //...
      'upyun' => [
                'driver'        => 'upyun',
                'bucket'        => 'your-bucket-name',// 服务名字
                'operator'      => 'oparator-name', // 操作员的名字
                'password'      => 'operator-password', // 操作员的密码
                'domain'        => 'xxxxx.b0.upaiyun.com', // 服务分配的域名
                'protocol'     => 'https', // 服务使用的协议，如需使用 http，在此配置 http
            ],
    //...
];
```

API 和方法调用
=========

[](#api-和方法调用)

```
bool $flysystem->write('file.md', 'contents');

bool $flysystem->writeStream('file.md', fopen('path/to/your/local/file.jpg', 'r'));

bool $flysystem->update('file.md', 'new contents');

bool $flysystem->updateStram('file.md', fopen('path/to/your/local/file.jpg', 'r'));

bool $flysystem->rename('foo.md', 'bar.md');

bool $flysystem->copy('foo.md', 'foo2.md');

bool $flysystem->delete('file.md');

bool $flysystem->has('file.md');

string|false $flysystem->read('file.md');

array $flysystem->listContents();

array $flysystem->getMetadata('file.md');

int $flysystem->getSize('file.md');

string $flysystem->getUrl('file.md');

string $flysystem->getMimetype('file.md');

int $flysystem->getTimestamp('file.md');
```

License
=======

[](#license)

MIT

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 78.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 ~269 days

Recently: every ~336 days

Total

6

Last Release

1946d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d583eca7b042d64c3eef336022603fd8ca499be01a0681c90c257b37af6582a7?d=identicon)[fly3949](/maintainers/fly3949)

---

Top Contributors

[![JellyBool](https://avatars.githubusercontent.com/u/6011686?v=4)](https://github.com/JellyBool "JellyBool (15 commits)")[![fly3949](https://avatars.githubusercontent.com/u/14029059?v=4)](https://github.com/fly3949 "fly3949 (2 commits)")[![jcc](https://avatars.githubusercontent.com/u/12684082?v=4)](https://github.com/jcc "jcc (1 commits)")[![overtrue](https://avatars.githubusercontent.com/u/1472352?v=4)](https://github.com/overtrue "overtrue (1 commits)")

---

Tags

laravelupyun

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/fly3949-flysystem-upyun/health.svg)

```
[![Health](https://phpackages.com/badges/fly3949-flysystem-upyun/health.svg)](https://phpackages.com/packages/fly3949-flysystem-upyun)
```

###  Alternatives

[unisharp/laravel-filemanager

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

2.2k3.3M73](/packages/unisharp-laravel-filemanager)[masbug/flysystem-google-drive-ext

Flysystem adapter for Google Drive with seamless virtual&lt;=&gt;display path translation

2631.7M14](/packages/masbug-flysystem-google-drive-ext)[yangyifan/upload

上传 SDK for Laravel

12422.6k3](/packages/yangyifan-upload)[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)
