PHPackages jackchow/qiniu-laravel - 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. jackchow/qiniu-laravel ActiveLibrary[File & Storage](/categories/file-storage) jackchow/qiniu-laravel ====================== Qiniu Resource (Cloud) Storage SDK for Laravel 5 v0.10.4(6y ago)0422MITPHPPHP >=5.3.3 Since Jun 27Pushed 6y agoCompare [ Source](https://github.com/jackchow123456/qiniu-laravel-storage)[ Packagist](https://packagist.org/packages/jackchow/qiniu-laravel)[ RSS](/packages/jackchow-qiniu-laravel/feed)WikiDiscussions master Synced yesterday READMEChangelogDependencies (2)Versions (36)Used By (0) Qiniu 云储存 Laravel 5 Storage版 ============================ [](#qiniu-云储存-laravel-5-storage版) 基于 开发 符合Laravel 5 的Storage用法。 注意 -- [](#注意) 从七牛获取到的`putTime`时间戳，是以 100纳秒 为单位的。 参考 PHP 可以用 [Carbon](http://carbon.nesbot.com/docs/) `Carbon::createFromTimestampMs($putTime/10000)` 来保证最大精度 JavaScript 可以用 [moment](http://momentjs.cn/docs/#/parsing/unix-offset/) `moment(putTime/10000)` 来保证最大精度 更新 -- [](#更新) v0.10 支持“公开空间”的 CDN 时间戳防盗链 v0.9 兼容 Laravel 5.5 的自动包安装功能 v0.8 1. 修正了getUrl 2. 修正了最新的 Qiniu API 适配 v0.7 1. 增加了 `withUploadToken`, `lastReturn` 等命令。 2. 修正了代码内的一些typo v0.6 增加了`fetch`, `qetag` 命令。 v0.5 增加了`QiniuUrl`来更方便的设置文件 URL 参数。 v0.3 增加了对PIPE以及回调地址参数的配置。 感谢abcsun提供的灵感。 v0.2 提供了对多域名的支持。这是为了配合七牛的默认域名、HTTPS域名和自定义域名而添加的功能。 安装 -- [](#安装) - `composer require zgldh/qiniu-laravel-storage` - `config/app.php` 里面的 `providers` 数组， 加上一行 `zgldh\QiniuStorage\QiniuFilesystemServiceProvider::class` - `config/filesystem.php` 里面的 `disks`数组加上： ``` 'disks' => [ ... , 'qiniu' => [ 'driver' => 'qiniu', 'domains' => [ 'default' => 'xxxxx.com1.z0.glb.clouddn.com', //你的七牛域名 'https' => 'dn-yourdomain.qbox.me', //你的HTTPS域名                'custom'   => 'static.abc.com',               //Useless 没啥用，请直接使用上面的 default 项 ], 'access_key'=> '', //AccessKey 'secret_key'=> '', //SecretKey 'bucket' => '', //Bucket名字 'notify_url'=> '', //持久化处理回调地址 'access' => 'public', //空间访问控制 public 或 private 'hotlink_prevention_key' => 'afc89ff8bd2axxxxxxxxxxxxxxbb', // CDN 时间戳防盗链的 key。 设置为 null 则不启用本功能。 // 'hotlink_prevention_key' => 'cbab68a279xxxxxxxxxxab509a', // 同上，备用 ], ], ``` - 完成 使用 -- [](#使用) 第一种用法 ``` $disk = \Storage::disk('qiniu'); $disk->exists('file.jpg'); //文件是否存在 $disk->get('file.jpg'); //获取文件内容 $disk->put('file.jpg',$contents); //上传文件 $disk->put('file.jpg',fopen('path/to/big.jpg','r+')); //分段上传文件。建议大文件>10Mb使用。 $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->url('a.png'); //返回文件的URL $disk->url(['path' => 'a.png', 'domainType' => 'default']); //返回文件的URL $disk->getDriver()->uploadToken(); //获取上传Token $disk->getDriver()->uploadToken('file.jpg'); //获取上传Token $disk->getDriver()->withUploadToken($token); // 使用自定义的 uploadToken 进行上传， $disk->put('file.jpg',$content); // 则本次的 put 操作，将使用上述的 $token 进行上传。 // 常用于自动触发持久化处理 https://github.com/qiniu/php-sdk/blob/master/examples/upload_and_pfop.php $disk->getDriver()->downloadUrl('file.jpg'); //获取下载地址 $disk->getDriver()->downloadUrl('file.jpg') ->setDownload('foo.jpg'); //获取下载地址，文件名为 foo.jpg $disk->getDriver()->downloadUrl('file.jpg', 'https'); //获取HTTPS下载地址 $disk->getDriver()->privateDownloadUrl('file.jpg'); //获取私有bucket下载地址 $disk->getDriver()->privateDownloadUrl('file.jpg?attname=foo.jpg'); //获取私有bucket下载地址，文件名为 foo.jpg $disk->getDriver()->privateDownloadUrl('file.jpg', 'https');//获取私有bucket的HTTPS下载地址 $disk->getDriver()->privateDownloadUrl('file.jpg', [ 'domain'=>'https', 'expires'=>3600 ]); //获取私有bucket的HTTPS下载地址。超时 3600 秒。 $disk->getDriver()->avInfo('file.mp3'); //获取多媒体文件信息 $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()->privateImagePreviewUrl('file.jpg','imageView2/0/w/100/h/200'); //获取私有bucket图片预览URL $disk->getDriver()->verifyCallback('application/x-www-form-urlencoded', $request->header('Authorization'), 'callback url', $request->getContent());//验证回调内容是否合法 $disk->getDriver()->persistentFop('file.flv','avthumb/m3u8/segtime/40/vcodec/libx264/s/320x240'); //执行持久化数据处理 $disk->getDriver()->persistentFop('file.flv','fop','队列名'); //使用私有队列执行持久化数据处理 $disk->getDriver()->persistentStatus($persistent_fop_id); //查看持久化数据处理的状态。 $disk->getDriver()->fetch('http://abc.com/foo.jpg', 'bar.jpg'); //调用fetch将 foo.jpg 数据以 bar.jpg 的名字储存起来。 $disk->getDriver()->qetag(); //得到最后一次执行 put, copy, append 等写入操作后，得到的hash值。详见 https://github.com/qiniu/qetag $disk->getDriver()->lastReturn(); //得到最后一次执行 put, copy, append 等写入操作后，得到的返回值。 ``` 第二种用法 （就是省略了一个getDriver） ``` use zgldh\QiniuStorage\QiniuStorage; $disk = QiniuStorage::disk('qiniu'); $disk->exists('file.jpg'); //文件是否存在 $disk->get('file.jpg'); //获取文件内容 $disk->put('file.jpg',$contents); //上传文件 $disk->put('file.jpg',fopen('path/to/big.jpg','r+')); //分段上传文件。建议大文件>10Mb使用。 $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 $disk->uploadToken('file.jpg'); //获取上传Token $disk->withUploadToken($token); // 使用自定义的 uploadToken 进行上传， $disk->put('file.jpg',$content); // 则本次的 put 操作，将使用上述的 $token 进行上传。 // 常用于自动触发持久化处理 https://github.com/qiniu/php-sdk/blob/master/examples/upload_and_pfop.php $disk->downloadUrl('file.jpg'); //获取下载地址 $disk->downloadUrl('file.jpg') ->setDownload('foo.jpg'); //获取下载地址，文件名为 foo.jpg $disk->downloadUrl('file.jpg', 'https'); //获取HTTPS下载地址 $disk->privateDownloadUrl('file.jpg'); //获取私有bucket下载地址 $disk->privateDownloadUrl('file.jpg?attname=foo.jpg'); //获取私有bucket下载地址，文件名为 foo.jpg $disk->privateDownloadUrl('file.jpg', 'https'); //获取私有bucket的HTTPS下载地址 $disk->privateDownloadUrl('file.jpg', [ 'domain'=>'https', 'expires'=>3600 ]); //获取私有bucket的HTTPS下载地址。超时 3600 秒。 $disk->avInfo('file.mp3'); //获取多媒体文件信息 $disk->imageInfo('file.jpg'); //获取图片信息 $disk->imageExif('file.jpg'); //获取图片EXIF信息 $disk->imagePreviewUrl('file.jpg','imageView2/0/w/100/h/200'); //获取图片预览URL $disk->privateImagePreviewUrl('file.jpg','imageView2/0/w/100/h/200'); //获取私有bucket图片预览URL $disk->verifyCallback('application/x-www-form-urlencoded', $request->header('Authorization'), 'callback url', $request->getContent());//验证回调内容是否合法 $disk->persistentFop('file.flv','avthumb/m3u8/segtime/40/vcodec/libx264/s/320x240'); //执行持久化数据处理 $disk->persistentFop('file.flv','fop','队列名'); //使用私有队列执行持久化数据处理 $disk->persistentStatus($persistent_fop_id); //查看持久化数据处理的状态。 $disk->fetch('http://abc.com/foo.jpg', 'bar.jpg'); //调用fetch将 foo.jpg 数据以 bar.jpg 的名字储存起来。 $disk->qetag(); //得到最后一次执行 put, copy, append 等写入操作后，得到的hash值。详见 https://github.com/qiniu/qetag $disk->lastReturn();//得到最后一次执行 put, copy, append 等写入操作后，得到的返回值。 ``` 官方SDK / 手册 ---------- [](#官方sdk--手册) - - ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity12 Limited adoption so far Community18 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor3 3 contributors hold 50%+ of commits 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 ~51 days Recently: every ~130 days Total 34 Last Release 2277d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/65cf574c970acb8b7abb798b49af192e6ea33629b30a5a7edd942672ca4282b9?d=identicon)[jackchow123456](/maintainers/jackchow123456) --- Top Contributors [![longbai](https://avatars.githubusercontent.com/u/1204301?v=4)](https://github.com/longbai "longbai (86 commits)")[![rwifeng](https://avatars.githubusercontent.com/u/1814146?v=4)](https://github.com/rwifeng "rwifeng (72 commits)")[![zgldh](https://avatars.githubusercontent.com/u/312404?v=4)](https://github.com/zgldh "zgldh (70 commits)")[![xushiwei](https://avatars.githubusercontent.com/u/396972?v=4)](https://github.com/xushiwei "xushiwei (67 commits)")[![dtynn](https://avatars.githubusercontent.com/u/1426666?v=4)](https://github.com/dtynn "dtynn (37 commits)")[![longshanksmo](https://avatars.githubusercontent.com/u/2968746?v=4)](https://github.com/longshanksmo "longshanksmo (17 commits)")[![django-wong](https://avatars.githubusercontent.com/u/4019240?v=4)](https://github.com/django-wong "django-wong (4 commits)")[![abcsun](https://avatars.githubusercontent.com/u/1784061?v=4)](https://github.com/abcsun "abcsun (4 commits)")[![callmez](https://avatars.githubusercontent.com/u/1625891?v=4)](https://github.com/callmez "callmez (3 commits)")[![branchzero](https://avatars.githubusercontent.com/u/7685609?v=4)](https://github.com/branchzero "branchzero (2 commits)")[![5-say](https://avatars.githubusercontent.com/u/6258835?v=4)](https://github.com/5-say "5-say (2 commits)")[![jackchow123456](https://avatars.githubusercontent.com/u/29397015?v=4)](https://github.com/jackchow123456 "jackchow123456 (2 commits)")[![peichao01](https://avatars.githubusercontent.com/u/844740?v=4)](https://github.com/peichao01 "peichao01 (2 commits)")[![hantuo](https://avatars.githubusercontent.com/u/873728?v=4)](https://github.com/hantuo "hantuo (2 commits)")[![motian](https://avatars.githubusercontent.com/u/2382215?v=4)](https://github.com/motian "motian (1 commits)")[![wenjy](https://avatars.githubusercontent.com/u/19709071?v=4)](https://github.com/wenjy "wenjy (1 commits)")[![xcaptain](https://avatars.githubusercontent.com/u/4054836?v=4)](https://github.com/xcaptain "xcaptain (1 commits)")[![BluntBlade](https://avatars.githubusercontent.com/u/1274124?v=4)](https://github.com/BluntBlade "BluntBlade (1 commits)")[![xuzhaokui](https://avatars.githubusercontent.com/u/962469?v=4)](https://github.com/xuzhaokui "xuzhaokui (1 commits)")[![frowhy](https://avatars.githubusercontent.com/u/16863314?v=4)](https://github.com/frowhy "frowhy (1 commits)") --- Tags laravelsdkcloudstorageqiniu ### Embed Badge ![Health badge](/badges/jackchow-qiniu-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/jackchow-qiniu-laravel/health.svg)](https://phpackages.com/packages/jackchow-qiniu-laravel) ``` ### 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)[yangyifan/upload 上传 SDK for Laravel 12422.6k3](/packages/yangyifan-upload) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)