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

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

qbhy/flysystem-upyun
====================

Flysystem and Laravel adapter for the Upyun storage.

v2.0.1(4y ago)1110MITPHPPHP >=7.3

Since May 4Pushed 4y agoCompare

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

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

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

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

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

[![Build Status](https://camo.githubusercontent.com/838cd82fd5c2bdcb8029705abc9c4ec53a4c6325b52b070a9e7785ad4fee7fbe/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f716268792f666c7973797374656d2d757079756e2f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/qbhy/flysystem-upyun/build-status/master)[![Quality Score](https://camo.githubusercontent.com/dcf95981d55925fb0f455d332e371aeb5fe56d80ccc580e0ae379039257eb34f/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f716268792f666c7973797374656d2d757079756e2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/qbhy/flysystem-upyun/build-status/master)[![Latest Stable Version](https://camo.githubusercontent.com/6dd47ad9913f470b7041fc66ae0ee283b21e116f33b386209cea9e94ad3e7a76/68747470733a2f2f706f7365722e707567782e6f72672f716268792f666c7973797374656d2d757079756e2f762f737461626c652e737667)](https://packagist.org/packages/qbhy/flysystem-upyun)[![Latest Unstable Version](https://camo.githubusercontent.com/39ff8d996bfa6641dc86cfeda01f67465047ec5e463752d06f912d3981aa723c/68747470733a2f2f706f7365722e707567782e6f72672f716268792f666c7973797374656d2d757079756e2f762f756e737461626c652e737667)](https://packagist.org/packages/qbhy/flysystem-upyun)[![Total Downloads](https://camo.githubusercontent.com/2bdb5f8088f9632ed2b237e549107796a3b90b018c33d31f8924ba51164c8248/68747470733a2f2f706f7365722e707567782e6f72672f716268792f666c7973797374656d2d757079756e2f646f776e6c6f616473)](https://packagist.org/packages/qbhy/flysystem-upyun)[![License](https://camo.githubusercontent.com/69711c85910c36686f6487bb367e1459a53b7c4cb527c0ef63fcd1335ac33d83/68747470733a2f2f706f7365722e707567782e6f72672f716268792f666c7973797374656d2d757079756e2f6c6963656e7365)](https://packagist.org/packages/qbhy/flysystem-upyun)

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

[](#requirement)

- PHP >= 5.5.9

视频教程
====

[](#视频教程)

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

安装
==

[](#安装)

直接可以通过 composer 来安装:

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

使用
==

[](#使用)

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

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

```
use League\Flysystem\Filesystem;
use Qbhy\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...
    Qbhy\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

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 88.2% 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 ~277 days

Recently: every ~413 days

Total

7

Last Release

1632d ago

Major Versions

1.0.5 → v2.0.02021-11-18

PHP version history (2 changes)1.0.1PHP >=5.5.9

v2.0.0PHP >=7.3

### Community

Maintainers

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

---

Top Contributors

[![JellyBool](https://avatars.githubusercontent.com/u/6011686?v=4)](https://github.com/JellyBool "JellyBool (15 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/qbhy-flysystem-upyun/health.svg)

```
[![Health](https://phpackages.com/badges/qbhy-flysystem-upyun/health.svg)](https://phpackages.com/packages/qbhy-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<=>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)