PHPackages jefferyjob/qiniu-laravel-storage - 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. jefferyjob/qiniu-laravel-storage ActiveLibrary[File & Storage](/categories/file-storage) jefferyjob/qiniu-laravel-storage ================================ Qiniu Resource (Cloud) Storage SDK for Laravel 5/6/7/8/9/10 v1.0.4(2y ago)019MITPHPPHP >=8.0 Since Jan 12Pushed 2y ago1 watchersCompare [ Source](https://github.com/jefferyjob/qiniu-laravel-storage)[ Packagist](https://packagist.org/packages/jefferyjob/qiniu-laravel-storage)[ RSS](/packages/jefferyjob-qiniu-laravel-storage/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)Dependencies (3)Versions (6)Used By (0) Qiniu 云储存 Laravel 5/6/7/8/9/10 Storage版 ======================================= [](#qiniu-云储存-laravel-5678910-storage版) 基于 开发 符合Laravel 5/6/7/8/9/10 的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)` 来保证最大精度 安装 -- [](#安装) - `composer require Jefferyjob/qiniu-laravel-storage:^1.0` - `config/app.php` 里面的 `providers` 数组， 加上一行 `Jefferyjob\QiniuStorage\QiniuFilesystemServiceProvider::class` - `config/filesystem.php` 里面的 `disks`数组加上： ``` 'disks' => [ // ... 'qiniu' => [ 'driver' => 'qiniu', 'domains' => [ 'default' => 'http://xxxxx.com1.z0.glb.clouddn.com', //你的七牛域名 'https' => 'https://dn-yourdomain.qbox.me', //你的HTTPS域名 'custom' => 'https://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->getAdapter()->uploadToken(); //获取上传Token $disk->getAdapter()->uploadToken('file.jpg'); //获取上传Token $disk->getAdapter()->withUploadToken($token); // 使用自定义的 uploadToken 进行上传， $disk->put('file.jpg',$content); // 则本次的 put 操作，将使用上述的 $token 进行上传。 // 常用于自动触发持久化处理 https://github.com/qiniu/php-sdk/blob/master/examples/upload_and_pfop.php $disk->getAdapter()->downloadUrl('file.jpg'); //获取下载地址 $disk->getAdapter()->downloadUrl('file.jpg') ->setDownload('foo.jpg'); //获取下载地址，文件名为 foo.jpg $disk->getAdapter()->downloadUrl('file.jpg', 'https'); //获取HTTPS下载地址 $disk->getAdapter()->privateDownloadUrl('file.jpg'); //获取私有bucket下载地址 $disk->getAdapter()->privateDownloadUrl('file.jpg?attname=foo.jpg'); //获取私有bucket下载地址，文件名为 foo.jpg $disk->getAdapter()->privateDownloadUrl('file.jpg', 'https');//获取私有bucket的HTTPS下载地址 $disk->getAdapter()->privateDownloadUrl('file.jpg', [ 'domain'=>'https', 'expires'=>3600 ]); //获取私有bucket的HTTPS下载地址。超时 3600 秒。 $disk->getAdapter()->avInfo('file.mp3'); //获取多媒体文件信息 $disk->getAdapter()->imageInfo('file.jpg'); //获取图片信息 $disk->getAdapter()->imageExif('file.jpg'); //获取图片EXIF信息 $disk->getAdapter()->imagePreviewUrl('file.jpg','imageView2/0/w/100/h/200'); //获取图片预览URL $disk->getAdapter()->privateImagePreviewUrl('file.jpg','imageView2/0/w/100/h/200'); //获取私有bucket图片预览URL $disk->getAdapter()->verifyCallback('application/x-www-form-urlencoded', $request->header('Authorization'), 'callback url', $request->getContent());//验证回调内容是否合法 $disk->getAdapter()->persistentFop('file.flv','avthumb/m3u8/segtime/40/vcodec/libx264/s/320x240'); //执行持久化数据处理 $disk->getAdapter()->persistentFop('file.flv','fop','队列名'); //使用私有队列执行持久化数据处理 $disk->getAdapter()->persistentStatus($persistent_fop_id); //查看持久化数据处理的状态。 $disk->getAdapter()->fetch('http://abc.com/foo.jpg', 'bar.jpg'); //调用fetch将 foo.jpg 数据以 bar.jpg 的名字储存起来。 $disk->getAdapter()->qetag(); //得到最后一次执行 put, copy, append 等写入操作后，得到的hash值。详见 https://github.com/qiniu/qetag $disk->getAdapter()->lastReturn(); //得到最后一次执行 put, copy, append 等写入操作后，得到的返回值。 ``` 第二种用法 （就是省略了一个getAdapter） ``` use Jefferyjob\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 23 — LowBetter than 27% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community7 Small or concentrated contributor base Maturity50 Maturing project, gaining track record 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 ~2 days Total 5 Last Release 844d ago PHP version history (2 changes)v1.0.0PHP >=5.3.3 v1.0.3PHP >=8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/50bca77c709c1787142d32a6f1b3593fabae01591dd996f736ddae4a4618bf7a?d=identicon)[jefferyjob](/maintainers/jefferyjob) --- Top Contributors [![jefferyjob](https://avatars.githubusercontent.com/u/24731115?v=4)](https://github.com/jefferyjob "jefferyjob (10 commits)") --- Tags laravellibrarypackagephpqiniularavelsdkcloudstorageqiniu ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/jefferyjob-qiniu-laravel-storage/health.svg) ``` [![Health](https://phpackages.com/badges/jefferyjob-qiniu-laravel-storage/health.svg)](https://phpackages.com/packages/jefferyjob-qiniu-laravel-storage) ``` ### 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)