https://github.com/overtrue/flysystem-qiniu
:floppy_disk: Flysystem adapter for the Qiniu storage.
https://github.com/overtrue/flysystem-qiniu
flysystem flysystem-adapter qiniu qiniu-sdk storage
Last synced: about 1 month ago
JSON representation
:floppy_disk: Flysystem adapter for the Qiniu storage.
- Host: GitHub
- URL: https://github.com/overtrue/flysystem-qiniu
- Owner: overtrue
- Created: 2017-03-14T12:15:23.000Z (about 8 years ago)
- Default Branch: 3.x
- Last Pushed: 2025-03-24T13:13:15.000Z (2 months ago)
- Last Synced: 2025-04-14T18:03:53.257Z (about 1 month ago)
- Topics: flysystem, flysystem-adapter, qiniu, qiniu-sdk, storage
- Language: PHP
- Size: 93.8 KB
- Stars: 222
- Watchers: 5
- Forks: 41
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
## Flysystem Adapter for Qiniu Cloud Storage
:floppy_disk: Flysystem adapter for the Qiniu cloud storage.
[](https://travis-ci.org/overtrue/flysystem-qiniu)
[](https://packagist.org/packages/overtrue/flysystem-qiniu)
[](https://packagist.org/packages/overtrue/flysystem-qiniu)
[](https://scrutinizer-ci.com/g/overtrue/flysystem-qiniu/?branch=master)
[](https://scrutinizer-ci.com/g/overtrue/flysystem-qiniu/?branch=master)
[](https://packagist.org/packages/overtrue/flysystem-qiniu)
[](https://packagist.org/packages/overtrue/flysystem-qiniu)
[](https://github.com/sponsors/overtrue)
# Requirement
- PHP >= 8.0.2
# Installation
```shell
$ composer require "overtrue/flysystem-qiniu"
```
# Usage
```php
use League\Flysystem\Filesystem;
use Overtrue\Flysystem\Qiniu\QiniuAdapter;
use Overtrue\Flysystem\Qiniu\Plugins\FetchFile;
$accessKey = 'xxxxxx';
$secretKey = 'xxxxxx';
$bucket = 'test-bucket-name';
$domain = 'xxxx.bkt.clouddn.com'; // or with protocol: https://xxxx.bkt.clouddn.com
$adapter = new QiniuAdapter($accessKey, $secretKey, $bucket, $domain);
$flysystem = new League\Flysystem\Filesystem($adapter);
```
## API
```php
bool $flysystem->write('file.md', 'contents');
bool $flysystem->write('file.md', 'http://httpbin.org/robots.txt', ['mime' => 'application/redirect302']);
bool $flysystem->writeStream('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');
bool $flysystem->fileExists('file.md');
bool $flysystem->directoryExists('path/to/dir');
string|false $flysystem->read('file.md');
array $flysystem->listContents();
int $flysystem->fileSize('file.md');
string $flysystem->mimeType('file.md');
```
Adapter extended methods:
```php
string $adapter->getUrl('file.md');
bool|array $adapter->fetch(string $path, string $url);
array $adapter->refresh(string $path);
string $adapter->getTemporaryUrl($path, int|string|\DateTimeInterface $expiration);
string $adapter->privateDownloadUrl(string $path, int $expires = 3600);
string $adapter->getUploadToken(string $key = null, int $expires = 3600, string $policy = null, string $strictPolice = null)
```
# Integration
- Laravel: [overtrue/laravel-filesystem-qiniu](https://github.com/overtrue/laravel-filesystem-qiniu)
- Yii2: [krissss/yii2-filesystem-qiniu](https://github.com/krissss/yii2-filesystem-qiniu)
## :heart: Sponsor me
[](https://github.com/sponsors/overtrue)
如果你喜欢我的项目并想支持它，[点击这里 :heart:](https://github.com/sponsors/overtrue)
## Project supported by JetBrains
Many thanks to Jetbrains for kindly providing a license for me to work on this and other open-source projects.
[](https://www.jetbrains.com/?from=https://github.com/overtrue)
## PHP 扩展包开发
> 想知道如何从零开始构建 PHP 扩展包？
>
> 请关注我的实战课程，我会在此课程中分享一些扩展开发经验 —— [《PHP 扩展包实战教程 - 从入门到发布》](https://learnku.com/courses/creating-package)
# License
MIT