在 Laravel 5 中集成七牛雲存儲實現雲存儲功能
阿新 • • 發佈：2019-01-22
abc example 官方 中新 ice str laravel hot 分段
本擴展包基於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‘ => ‘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 等寫入操作後，得到的返回值。
三、相關參考
本擴展包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
在 Laravel 5 中集成七牛雲存儲實現雲存儲功能