本扩展包基于https://github.com/qiniu/php-sdk开发,是七牛云储存 Laravel 5 Storage版,通过本扩展包可以在Laravel 5中集成七牛云存储功能。
1、安装配置
使用之前,先通过Composer安装:
composer require zgldh/qiniu-laravel-storage
然后在config/app.php中注册服务提供者:
zgldh\QiniuStorage\QiniuFilesystemServiceProvider::class
接下来在config/filesystems.php里的disks中新增如下选项:
\'disks\' => [
... ,
\'qiniu\' => [
\'driver\' => \'qiniu\',
\'domains\' => [
\'default\' => \'laravelacademy.com1.z0.glb.clouddn.com\', //你的七牛域名
\'https\' => \'dn-laravelacademy.qbox.me\', //你的HTTPS域名
\'custom\' => \'static.laravelacademy.org\', //你的自定义域名
],
\'access_key\'=> \'\', //AccessKey
\'secret_key\'=> \'\', //SecretKey
\'bucket\' => \'\', //Bucket名字
\'notify_url\'=> \'\', //持久化处理回调地址
],
],
2、使用
第一种用法:
$disk = \Storage::disk(\'qiniu\');
$disk->exists(\'file.jpg\'); //文件是否存在
$disk->get(\'file.jpg\'); //获取文件内容
$disk->put(\'file.jpg\',$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(\'file.jpg\'); //获取上传Token
$disk->getDriver()->downloadUrl(\'file.jpg\'); //获取下载地址
$disk->getDriver()->downloadUrl(\'file.jpg\', \'https\'); //获取HTTPS下载地址
$disk->getDriver()->privateDownloadUrl(\'file.jpg\'); //获取私有bucket下载地址
$disk->getDriver()->privateDownloadUrl(\'file.jpg\', \'https\');//获取私有bucket的HTTPS下载地址
$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()->persistentFop(\'file.flv\',\'fop\',\'队列名\'); //使用私有队列执行持久化数据处理
$disk->getDriver()->persistentStatus($persistent_fop_id); //查看持久化数据处理的状态。
第二种用法 (就是省略了一个getDriver):
use zgldh\QiniuStorage\QiniuStorage;
$disk = QiniuStorage::disk(\'qiniu\');
$disk->exists(\'file.jpg\'); //文件是否存在
$disk->get(\'file.jpg\'); //获取文件内容
$disk->put(\'file.jpg\',$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(\'file.jpg\'); //获取上传Token
$disk->downloadUrl(\'file.jpg\'); //获取下载地址
$disk->downloadUrl(\'file.jpg\', \'https\'); //获取HTTPS下载地址
$disk->privateDownloadUrl(\'file.jpg\'); //获取私有bucket下载地址
$disk->privateDownloadUrl(\'file.jpg\', \'https\'); //获取私有bucket的HTTPS下载地址
$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->persistentFop(\'file.flv\',\'fop\',\'队列名\'); //使用私有队列执行持久化数据处理
$disk->persistentStatus($persistent_fop_id); //查看持久化数据处理的状态。
3、相关参考
本扩展包GitHub地址为https://github.com/zgldh/qiniu-laravel-storage,基于https://github.com/qiniu/php-sdk开发,更多详情请参考七牛官方PHP SDK使用指南:http://developer.qiniu.com/code/v7/sdk/php.html