PHPackages sa0chunluyu/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 & Storage](/categories/file-storage) 4. / 5. sa0chunluyu/laravel-storage-qiniu ActiveLibrary[File & Storage](/categories/file-storage) sa0chunluyu/laravel-storage-qiniu ================================= A storage library for laravel5 and qiniu sdk v1.2.2(3y ago)017MITPHPPHP >=5.3.3 Since May 30Pushed 3y agoCompare [ Source](https://github.com/sa0ChunLuyu/laravel-storage-qiniu)[ Packagist](https://packagist.org/packages/sa0chunluyu/laravel-storage-qiniu)[ RSS](/packages/sa0chunluyu-laravel-storage-qiniu/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (15)Used By (0) Laravel5 七牛存储组件（使用官方SDK） ======================== [](#laravel5-七牛存储组件使用官方sdk) 对七牛官方组件再次封装，以简化在 Laravel 中的使用成本。 sa0ChunLuyu May 29 2022 ----------------------- [](#sa0chunluyu-may-29-2022) 解决了在执行删除操作时候的报错 ``` Storage::disk('qiniu')->delete($path); // qiniu-laravel-storage\src\QiniuAdapter.php // 第339行左右 $error = $bucketMgr->delete($this->bucket, $path); // 替换为 list ($ret, $error) = $bucketMgr->delete ($this->bucket, $path); ``` 注意 -- [](#注意) 最初找到了原作者的项目，使用 composer 安装完，发现完全不对。所以变更了代码，以便可以通过 composer 的方式引入该组件和七牛组件，鉴于有同学也在用这个，而且原项目做的某些变更我不认同，因此保留该项目至今，基本不开发新功能，接受 pr。想看原作者项目的请去 安装 -- [](#安装) - `composer require sa0chunluyu/laravel-storage-qiniu` - `config/app.php` 里面的 `providers` 数组， 加上一行 `sa0chunluyu\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 sa0chunluyu\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 28 — LowBetter than 54% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community8 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor1 Top contributor holds 75.8% 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 ~212 days Recently: every ~464 days Total 13 Last Release 1445d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/e7467dd39efe764ae33f78bc1e7bc49500afa38bf73dae35508bd1919bb98224?d=identicon)[sa0ChunLuyu](/maintainers/sa0ChunLuyu) --- Top Contributors [![itbdw](https://avatars.githubusercontent.com/u/1267057?v=4)](https://github.com/itbdw "itbdw (25 commits)")[![sa0ChunLuyu](https://avatars.githubusercontent.com/u/46621242?v=4)](https://github.com/sa0ChunLuyu "sa0ChunLuyu (8 commits)") --- Tags laravelsdkcloudstoragelaravel5qiniu ### Embed Badge ![Health badge](/badges/sa0chunluyu-laravel-storage-qiniu/health.svg) ``` [![Health](https://phpackages.com/badges/sa0chunluyu-laravel-storage-qiniu/health.svg)](https://phpackages.com/packages/sa0chunluyu-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)[itbdw/laravel-storage-qiniu A storage library for laravel5 and qiniu sdk 7015.2k](/packages/itbdw-laravel-storage-qiniu) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)