PHPackages caiyundong/yii2-qiniu-sdk - 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. caiyundong/yii2-qiniu-sdk ActiveYii2-extension caiyundong/yii2-qiniu-sdk ========================= Qiniu API for Yii 2.0 111PHP Since Aug 1Pushed 7y ago1 watchersCompare [ Source](https://github.com/caiyundong/yii2-qiniu-sdk)[ Packagist](https://packagist.org/packages/caiyundong/yii2-qiniu-sdk)[ RSS](/packages/caiyundong-yii2-qiniu-sdk/feed)WikiDiscussions master Synced yesterday READMEChangelogDependenciesVersions (1)Used By (0) yii2-qiniu-sdk ============== [](#yii2-qiniu-sdk) 基于Yii2实现的七牛云存储API SDK（使用官方SDK） 环境条件 ---- [](#环境条件) - > = PHP 5.4 - > = Yii 2.0 - cURL extension 安装 -- [](#安装) 添加下列代码在`composer.json`文件中并执行`composer update --no-dev`操作 ``` { "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'); .... ``` 使用示例 ---- [](#使用示例) 上传文件（通过路径） ``` $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']; // 错误信息 } ``` 上传文件（通过内容） ``` $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']; // 错误信息 } ``` 获取私有文件下载链接 ``` $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 } ``` 获取上传凭证 ``` $bucket = 'test_bucket'; $key = null; $expires = 7200; $policy = null; $token = Yii::$app->qiniu->uploadToken($bucket, $key, $expires, $policy); // TODO ``` 删除文件 ``` $ret = Yii::$app->qiniu->delete($key); if ($ret['code'] === 0) { // 删除成功 $url = $ret['result']['url']; } else { // 删除失败 $code = $ret['code']; // 错误码 $message = $ret['message']; // 错误信息 } ``` Bucket Management ``` // 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 ``` // 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 ``` // 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 ### Health Score 20 — LowBetter than 14% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community9 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 63.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. ### Community Maintainers ![](https://www.gravatar.com/avatar/7490a83a9ec59280020a25c4eea05867a0d93f6bb6426ba21896d3cbf4e757fd?d=identicon)[caiyundong](/maintainers/caiyundong) --- Top Contributors [![caiyundong](https://avatars.githubusercontent.com/u/1865812?v=4)](https://github.com/caiyundong "caiyundong (12 commits)")[![chocoboxxf](https://avatars.githubusercontent.com/u/3401509?v=4)](https://github.com/chocoboxxf "chocoboxxf (7 commits)") ### Embed Badge ![Health badge](/badges/caiyundong-yii2-qiniu-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/caiyundong-yii2-qiniu-sdk/health.svg)](https://phpackages.com/packages/caiyundong-yii2-qiniu-sdk) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)