caiyundong/yii2-qiniu-sdk

Qiniu API for Yii 2.0

yii2-qiniu-sdk

基于Yii2实现的七牛云存储API SDK（使用官方SDK）, _(*1)

环境条件

• >= PHP 5.4
• >= Yii 2.0
• cURL extension

安装

添加下列代码在composer.json文件中并执行composer update --no-dev操作, _(*2)

{
    "require": {
       "caiyundong/yii2-qiniu-sdk": "dev-master"
    }
}

设置方法

// 全局使用
// 在config/main.php配置文件中定义component配置信息
'components' => [
  .....
  'qiniu' => [ 
      'class' => 'caiyundong\Qiniu\Qiniu',
      'accessKey' => 'Access Key',
      'secretKey' => 'Secret Key',
      'domain' => '七牛域名',
      'bucket' => '空间名',
      'secure' => false, // 是否使用HTTPS，默认为false
  ]
  ....
]
// 代码中调用
$result = Yii::$app->qiniu->putFile('img/test.jpg', __DIR__.'/test.jpg');
....

// 局部调用
$qiniu = Yii::createObject([
    'class' => 'caiyundong\Qiniu\Qiniu',
    'accessKey' => 'Access Key',
    'secretKey' => 'Secret Key',
    'domain' => '七牛域名',
    'bucket' => '空间名',
    'secure' => false, // 是否使用HTTPS，默认为false
]);
$result = $qiniu->putFile('img/test.jpg', __DIR__.'/test.jpg');
....

使用示例

上传文件（通过路径）, _(*3)

$ret = Yii::$app->qiniu->putFile('img/test.jpg', __DIR__.'/test.jpg');
if ($ret['code'] === 0) {
    // 上传成功
    $url = $ret['result']['url']; // 目标文件的URL地址，如：http://[七牛域名]/img/test.jpg
} else {
    // 上传失败
    $code = $ret['code']; // 错误码
    $message = $ret['message']; // 错误信息
}

上传文件（通过内容）, _(*4)

$fileData = file_get_contents(__DIR__.'/test.jpg');
$ret = Yii::$app->qiniu->put('img/test.jpg', $fileData);
if ($ret['code'] === 0) {
    // 上传成功
    $url = $ret['result']['url']; // 目标文件的URL地址，如：http://[七牛域名]/img/test.jpg
} else {
    // 上传失败
    $code = $ret['code']; // 错误码
    $message = $ret['message']; // 错误信息
}

获取私有文件下载链接, _(*5)

$fileList = [
    'http://domain/private-file1.jpg',
    'http://domain/private-file2.jpg',
    'http://domain/private-file3.jpg',
];
$urlMaps = Yii::$app->qiniu->batchDownload($fileList);
foreach ($urlMaps as $fileUrl => $downloadUrl) {
    // TODO
}

获取上传凭证, _(*6)

$bucket = 'test_bucket';
$key = null;
$expires = 7200;
$policy = null;
$token = Yii::$app->qiniu->uploadToken($bucket, $key, $expires, $policy);
// TODO

删除文件, _(*7)

$ret = Yii::$app->qiniu->delete($key);
if ($ret['code'] === 0) {
    // 删除成功
    $url = $ret['result']['url']; 
} else {
    // 删除失败
    $code = $ret['code']; // 错误码
    $message = $ret['message']; // 错误信息
}

Bucket Management, _(*8)

// buckets
$shared = true;
$buckets = Yii::$app->qiniu->buckets($shared);

// domains
$buckets = Yii::$app->qiniu->domains($bucket);

// listFiles
$listFiles = Yii::$app->qiniu->listFiles($bucket, $prefix, $marker, $limit, $delimiter);

// file stat
$stat = Yii::$app->qiniu->stat($bucket, $key);

// file rename
$result = Yii::$app->qiniu->rename($bucket, $oldfile, $newfile);

// file copy
$result = Yii::$app->qiniu->copy($from_bucket, $from_key, $to_bucket, $to_key, $force);

// file move from one bucket to another
$result = Yii::$app->qiniu->move($from_bucket, $from_key, $to_bucket, $to_key, $force);

// change MIMES
$result = Yii::$app->qiniu->changeMime($bucket, $key, $mime);

// change type
$result = Yii::$app->qiniu->changeType($bucket, $key, $fileType);

// change status
$result = Yii::$app->qiniu->changeStatus($bucket, $key, $status);

// fetch
$result = Yii::$app->qiniu->fetch($url, $bucket, $key);

// prefetch
$result = Yii::$app->qiniu->prefetch($bucket, $key);

// batch - 在单次请求中进行多个资源管理操作
$result = Yii::$app->qiniu->batch($operations);

// deleteAfterDays
$result = Yii::$app->qiniu->deleteAfterDays($bucket, $key, $days);

ImageUrlBuilder, _(*9)

// get thumb url
$url = Yii::$app->qiniu->thumbnail($url, $mode, $width, $height, $format, $interlace, $quality, $ignoreError);

// image watermark
$url = Yii::$app->qiniu->waterImg($url, $image, $dissolve, $gravity, $dx, $dy, $watermarkScale);

// text watermark
$url = Yii::$app->qiniu->waterText( $url, $text, $font, $fontSize, $fontColor, $dissolve, $gravity, $dx, $dy);

Video Watermark, _(*10)

// IMAGE watermark
// key is old video file key
// new_key is new  video file key
Yii::$app->qiniu->waterVideo($key, $new_key, $watermark_url, $pipeline, $wmGravity, $wmOffsetX, $wmOffsetY, $notifyUrl);

// TEXT watermark
// key is old video file key
// new_key is new  video file key
Yii::$app->qiniu->waterVideoText($key, $new_key, $wmText, $pipeline, $wmGravityText, $wmFont,  $wmFontColor, $wmFontSize, $wmOffsetX, $wmOffsetY, $notifyUrl);

鸣谢

@chocoboxxf/yii2-qiniu-sdk, _(*11)