PHPackages                             itbdw/laravel-storage-qiniu - 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 &amp; Storage](/categories/file-storage)
4. /
5. itbdw/laravel-storage-qiniu

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

itbdw/laravel-storage-qiniu
===========================

A storage library for laravel5 and qiniu sdk

v1.1.0(8y ago)7015.2k↑125%11[1 issues](https://github.com/itbdw/laravel-storage-qiniu/issues)MITPHPPHP &gt;=5.3.3

Since May 30Pushed 8y ago7 watchersCompare

[ Source](https://github.com/itbdw/laravel-storage-qiniu)[ Packagist](https://packagist.org/packages/itbdw/laravel-storage-qiniu)[ RSS](/packages/itbdw-laravel-storage-qiniu/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (13)Used By (0)

不再维护
====

[](#不再维护)

尝试在用这个的同学注意了，建议直接 composer require qiniu/php-sdk 即可，自己再对需要的封装一下，更灵活。

Laravel5 七牛存储组件
---------------

[](#laravel5-七牛存储组件)

对七牛官方组件再次封装，以简化在 Laravel 中的使用成本。

注意
--

[](#注意)

最初找到了原作者的项目，使用 composer 安装完，发现完全不对。所以变更了代码，以便可以通过 composer 的方式引入该组件和七牛组件，鉴于有同学也在用这个，因此保留该项目至今，基本不开发新功能，接受 pr。想看原作者项目的请去

安装
--

[](#安装)

- `composer require itbdw/laravel-storage-qiniu`
- `config/app.php` 里面的 `providers` 数组， 加上一行 `itbdw\QiniuStorage\QiniuFilesystemServiceProvider`
- `config/filesystem.php` 里面的 `disks`数组加上：

```
    'disks' => [

        // 如果有多个 bucket，增加类似配置即可
        'qiniu' => [
            'driver' => 'qiniu',
            'domain' => 'https://www.example.com',          //你的七牛域名，支持 http 和 https，也可以不带协议，默认 http
            'access_key'    => '',                          //AccessKey
            'secret_key' => '',                             //SecretKey
            'bucket' => '',                                 //Bucket名字
        ],

        'qiniu_private' => [
            'driver' => 'qiniu',
            'domain' => 'https://www.example.com',          //你的七牛域名，支持 http 和 https，也可以不带协议，默认 http
            'access_key'    => '',                          //AccessKey
            'secret_key' => '',                             //SecretKey
            'bucket' => 'qiniu_private',                    //Bucket名字
        ],

        ...
    ],

```

使用
--

[](#使用)

第一种用法

```
    $disk = \Storage::disk('qiniu');
    $disk->exists('file.jpg');                      //文件是否存在
    $disk->get('file.jpg');                         //获取文件内容
    $disk->put('file.jpg',$contents);               //上传文件，$contents 二进制文件流
    $disk->prepend('file.log', 'Prepended Text');   //附加内容到文件开头
    $disk->append('file.log', 'Appended Text');     //附加内容到文件结尾
    $disk->delete('file.jpg');                      //删除文件
    $disk->delete(['file1.jpg', 'file2.jpg']);
    $disk->copy('old/file1.jpg', 'new/file1.jpg');  //复制文件到新的路径
    $disk->move('old/file1.jpg', 'new/file1.jpg');  //移动文件到新的路径

    $size = $disk->size('file1.jpg');               //取得文件大小
    $time = $disk->lastModified('file1.jpg');       //取得最近修改时间 (UNIX)
    $files = $disk->files($directory);              //取得目录下所有文件
    $files = $disk->allFiles($directory);               //取得目录下所有文件，包括子目录

    这三个对七牛来说无意义
    $directories = $disk->directories($directory);      //这个也没实现。。。
    $directories = $disk->allDirectories($directory);   //这个也没实现。。。
    $disk->makeDirectory($directory);               //这个其实没有任何作用

    $disk->deleteDirectory($directory);             //删除目录，包括目录下所有子文件子目录

    $disk->getDriver()->uploadToken();            //获取上传Token ,可选'file.jpg'
    $disk->getDriver()->putFile('file.jpg', 'local/filepath');            //上传本地大文件
    $disk->getDriver()->downloadUrl('file.jpg');            //获取下载地址
    $disk->getDriver()->privateDownloadUrl('file.jpg');     //获取私有bucket下载地址
    $disk->getDriver()->imageInfo('file.jpg');              //获取图片信息
    $disk->getDriver()->imageExif('file.jpg');              //获取图片EXIF信息
    $disk->getDriver()->imagePreviewUrl('file.jpg','imageView2/0/w/100/h/200');              //获取图片预览URL
    $disk->getDriver()->persistentFop('file.flv','avthumb/m3u8/segtime/40/vcodec/libx264/s/320x240');   //执行持久化数据处理
    $disk->getDriver()->persistentStatus($persistent_fop_id);          //查看持久化数据处理的状态。
    $disk->getDriver()->fetch($url, $key);          //从指定URL抓取资源，并将该资源存储到指定空间中。
```

第二种用法 （就是省略了一个getDriver）

```
    use itbdw\QiniuStorage\QiniuStorage;

    $disk = QiniuStorage::disk('qiniu');
    $disk->exists('file.jpg');                      //文件是否存在
    $disk->get('file.jpg');                         //获取文件内容
    $disk->put('file.jpg',$contents);               //上传文件，$contents 二进制文件流
    $disk->prepend('file.log', 'Prepended Text');   //附加内容到文件开头
    $disk->append('file.log', 'Appended Text');     //附加内容到文件结尾
    $disk->delete('file.jpg');                      //删除文件
    $disk->delete(['file1.jpg', 'file2.jpg']);
    $disk->copy('old/file1.jpg', 'new/file1.jpg');  //复制文件到新的路径
    $disk->move('old/file1.jpg', 'new/file1.jpg');  //移动文件到新的路径

    $size = $disk->size('file1.jpg');               //取得文件大小
    $time = $disk->lastModified('file1.jpg');       //取得最近修改时间 (UNIX)
    $files = $disk->files($directory);              //取得目录下所有文件
    $files = $disk->allFiles($directory);            //取得目录下所有文件，包括子目录

    这三个对七牛来说无意义
    $directories = $disk->directories($directory);      //这个也没实现。。。
    $directories = $disk->allDirectories($directory);   //这个也没实现。。。
    $disk->makeDirectory($directory);               //这个其实没有任何作用

    $disk->deleteDirectory($directory);             //删除目录，包括目录下所有子文件子目录

    $disk->uploadToken();            //获取上传Token ,可选参数'file.jpg'
    $disk->putFile('file.jpg', 'local/filepath');            //上传本地大文件
    $disk->downloadUrl('file.jpg');            //获取下载地址
    $disk->privateDownloadUrl('file.jpg');     //获取私有bucket下载地址
    $disk->imageInfo('file.jpg');              //获取图片信息
    $disk->imageExif('file.jpg');              //获取图片EXIF信息
    $disk->imagePreviewUrl('file.jpg','imageView2/0/w/100/h/200');              //获取图片预览URL
    $disk->persistentFop('file.flv','avthumb/m3u8/segtime/40/vcodec/libx264/s/320x240');   //执行持久化数据处理
    $disk->persistentStatus($persistent_fop_id);          //查看持久化数据处理的状态。
    $disk->fetch($url, $key);          //从指定URL抓取资源，并将该资源存储到指定空间中。
```

官方SDK / 手册
----------

[](#官方sdk--手册)

-
-

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity38

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~102 days

Recently: every ~212 days

Total

11

Last Release

2985d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8a4e26a47fd5873f6f9adff3849459a3f268cbc80f40d888827eddcb9f037d29?d=identicon)[itbdw](/maintainers/itbdw)

---

Top Contributors

[![itbdw](https://avatars.githubusercontent.com/u/1267057?v=4)](https://github.com/itbdw "itbdw (25 commits)")

---

Tags

laravelqiniusdklaravelsdkcloudstoragelaravel5qiniu

### Embed Badge

![Health badge](/badges/itbdw-laravel-storage-qiniu/health.svg)

```
[![Health](https://phpackages.com/badges/itbdw-laravel-storage-qiniu/health.svg)](https://phpackages.com/packages/itbdw-laravel-storage-qiniu)
```

###  Alternatives

[zgldh/qiniu-laravel-storage

Qiniu Resource (Cloud) Storage SDK for Laravel 5/6/7/8/9

530394.0k14](/packages/zgldh-qiniu-laravel-storage)[qiniu/php-sdk

Qiniu Resource (Cloud) Storage SDK for PHP

8483.0M240](/packages/qiniu-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
