https://github.com/jefferyjob/qiniu-laravel-storage
Qiniu 云储存 Laravel Storage版
https://github.com/jefferyjob/qiniu-laravel-storage
laravel library package php qiniu
Last synced: 3 months ago
JSON representation
Qiniu 云储存 Laravel Storage版
- Host: GitHub
- URL: https://github.com/jefferyjob/qiniu-laravel-storage
- Owner: jefferyjob
- License: mit
- Created: 2024-01-12T16:11:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-01-20T01:38:40.000Z (over 1 year ago)
- Last Synced: 2025-01-12T14:37:27.767Z (5 months ago)
- Topics: laravel, library, package, php, qiniu
- Language: PHP
- Homepage:
- Size: 60.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Qiniu 云储存 Laravel 5/6/7/8/9/10 Storage版
基于 https://github.com/qiniu/php-sdk 开发
符合Laravel 5/6/7/8/9/10 的Storage用法。
## 注意
从七牛获取到的`putTime`时间戳，是以 100纳秒 为单位的。
参考
- https://developer.qiniu.com/kodo/api/1308/stat
- https://developer.qiniu.com/kodo/api/1284/list
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```数组加上：
```php
'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', // 同上，备用
],
],
```
## 使用
第一种用法
```php
$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）
```php
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 / 手册
- https://github.com/qiniu/php-sdk
- http://developer.qiniu.com/docs/v6/sdk/php-sdk.html