Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dcb9/yii2-qiniu
The Qiniu integration for the Yii framework
https://github.com/dcb9/yii2-qiniu
Last synced: 3 months ago
JSON representation
The Qiniu integration for the Yii framework
- Host: GitHub
- URL: https://github.com/dcb9/yii2-qiniu
- Owner: dcb9
- Archived: true
- Created: 2016-05-30T16:20:21.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-10-17T01:59:06.000Z (about 8 years ago)
- Last Synced: 2024-08-08T09:58:46.359Z (5 months ago)
- Language: PHP
- Size: 44.9 KB
- Stars: 17
- Watchers: 2
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- awesome-yii2 - yii2-qiniu
README
Qiniu Extension for Yii2
=================
The Qiniu integration for the Yii framework
[](https://travis-ci.org/dcb9/yii2-qiniu)
[](https://codeclimate.com/github/dcb9/yii2-qiniu)
[](https://codeclimate.com/github/dcb9/yii2-qiniu)
[](https://packagist.org/packages/dcb9/yii2-qiniu)
[](https://packagist.org/packages/dcb9/yii2-qiniu)
[](https://packagist.org/packages/dcb9/yii2-qiniu)
[CHANGE LOG](CHANGELOG.md)
Installation
--------------------
The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
Either run
```
composer require --prefer-dist dcb9/yii2-qiniu
```
or add
```json
"dcb9/yii2-qiniu": "*"
```
to the `require` section of your composer.json.
Configuration
--------------------
To use this extension, simply add the following code in your application configuration:
```php
return [
//....
'components' => [
'qiniu' => [
'class' => 'dcb9\qiniu\Component',
'accessKey' => 'YOUR_ACCESS_KEY',
'secretKey' => 'YOUR_SECRET_KEY',
'disks' => [
'testBucket' => [
'bucket' => 'bucketOnQiniu',
'baseUrl' => 'ACCESS_QINIU_URL',
'isPrivate' => true,
'zone' => 'zone0', // 可设置为 zone0, zone1 @see \Qiniu\Zone
],
],
],
],
];
```
[资源操作](http://developer.qiniu.com/code/v6/api/kodo-api/index.html#资源操作)
--------------------
资源操作就 [Flysystem](https://github.com/thephpleague/flysystem) 的一个扩展, 所以所有的调用方法与 [Flysystem](https://github.com/thephpleague/flysystem) 调用方法一致.
```php
// 获取 Disk
$filesystem = Yii::$app->qiniu->getDisk('testBucket');
$filesystem->has('hello.txt');
// 七牛独有 API
$filesystem->getUrl('hello.txt'); // 获取访问地址
```
**[其它所有可调用的 API](http://flysystem.thephpleague.com/api/)**
#### [上传策略](http://developer.qiniu.com/article/developer/security/put-policy.html)
默认设置 Policy 是使用 Array 的方式来设置的, 但是这种方式对程序员不是很友好,于是创建了一个 Policy 的类,但所有的操作还是跟操作数组一样.
```php
$policy = new \dcb9\qiniu\Policy();
$policy->callbackUrl = '';
$policy->callbackBody = '';
```
#### [获取 UploadToken](http://developer.qiniu.com/article/developer/security/upload-token.html)
```php
$qiniu = Yii::$app->qiniu;
$diskName = 'testBucket';
$token1 = $qiniu->getUploadToken($diskName);
$key = null;
$expires = 3600;
$policy = new \dcb9\qiniu\Policy();
$policy->callbackUrl = '';
$policy->callbackBody = '';
// Fop @see src/Pfop.php
$policy->persistentOps = \dcb9\qiniu\Pfop::instance()
->avthumb('mp4')
->wmImage('http://o82pobmde.bkt.clouddn.com/yii2-logo.png')
->saveas('testbucket', 'after-ops' . date('Y-m-d H:i:s') . '.mp4')
->__toString();
$policy->persistentNotifyUrl = 'http://blog.phpor.me';
$diskName = 'testBucket';
$token2 = $qiniu->getUploadToken($diskName, $key, $expires, $policy);
```
#### 使用 Token 上传文件
```php
$token = ''; // @see 获取 UploadToken
$config = ['token' => $token];
$filesystem->writeStream($path, $stream, $config);
$filesystem->write($path, $content, $config);
$filesystem->put($path, $content, $config);
```
Tricks
--------------------
* 给配置的组件加 IDE 自动补全 [IDE autocompletion for custom components](https://github.com/samdark/yii2-cookbook/blob/master/book/ide-autocompletion.md)