Laravel 使用 Aliyun OSS 雲存儲

對象存儲 ( Object Storage Service, 簡稱 OSS ) OSS 相信你們都聽過, 它是阿里雲對外提供的海量, 安全和高可靠的雲存儲服務. 你們能夠把本身網站的資源存上面加快本身網站速度, aliyun 官網也有文檔不過對於新手來講有點難, 那麼這裏我給你們推薦一個組件和組件的使用.

johnlui/aliyun-oss 這個組件是 John Lui 做者封裝好的組件, 用法超簡單, 不過這個組件有許多要注意的地方, 否則出錯了, 掉坑裏爬不出來!

安裝

composer require "johnlui/aliyun-oss"

配置

組件下載完成以後, 做者的 GitHub 上面說須要在 app/config/app.php 中增長四項配置, 我建議在 app/config 下面新建一個 alioss.php 文件而後在添加配置:

<?php  
return [  
    'ossServer' => env('ALIOSS_SERVER', null),                      // 外網
    'ossServerInternal' => env('ALIOSS_SERVERINTERNAL', null),      // 內網
    'AccessKeyId' => env('ALIOSS_KEYID', null),                     // key
    'AccessKeySecret' => env('ALIOSS_KEYSECRET', null),             // secret
    'BucketName' => env('ALIOSS_BUCKETNAME', null)                  // bucket
];

而後在 .ENV 文件裏面把配置信息都填上.

注意

這裏有一個大坑, 粗心的朋友通常不會發現, 在填寫外網和公網配置的時候, 有的朋友直接在 OSS 管理控制檯中把外網和內網一長串的連接複製走, 以下圖:

在這個組件中, 桶名稱是須要額外填寫的, 因此外網和內網哪兒, 只須要填寫桶名後面的內容, 如圖:

再有一點是填寫外網和內網的時候須要加上 http:// 協議, 否則後面出錯你又得掉坑半天出不來, 最終配置信息以下圖:

構建 Service 文件

後臺須要一個 Service 文件, 在 app/Service 下新建一個 oss.php 文件, 因爲前面步驟我把配置文件放在 app/config/alioss.php 裏面, 因此還要對原做者給出的例子做修改下, 以下代碼:

# oss.php
<?php

namespace App\Services;

use JohnLui\AliyunOSS\AliyunOSS;


class OSS  
{

    private $ossClient;
    private static $bucketName;

    public function __construct($isInternal = false)
    {
        $serverAddress = $isInternal ? config('alioss.ossServerInternal') : config('alioss.ossServer');
        $this->ossClient = AliyunOSS::boot(
            $serverAddress,
            config('alioss.AccessKeyId'),
            config('alioss.AccessKeySecret')
        );
    }

    public static function upload($ossKey, $filePath)
    {
        $oss = new OSS(false); // 上傳文件使用內網，免流量費
        $oss->ossClient->setBucket(config('alioss.BucketName'));
        $res = $oss->ossClient->uploadFile($ossKey, $filePath);
        return $res;
    }

    /**
     * 直接把變量內容上傳到oss
     * @param $osskey
     * @param $content
     */
    public static function uploadContent($osskey, $content)
    {
        $oss = new OSS(false); // 上傳文件使用內網，免流量費
        $oss->ossClient->setBucket(config('alioss.BucketName'));
        $oss->ossClient->uploadContent($osskey, $content);

    }

    /**
     * 刪除存儲在oss中的文件
     *
     * @param string $ossKey 存儲的key（文件路徑和文件名）
     * @return
     */
    public static function deleteObject($ossKey)
    {
        $oss = new OSS(false); // 上傳文件使用內網，免流量費

        return $oss->ossClient->deleteObject(config('alioss.BucketName'), $ossKey);
    }

    /**
     * 複製存儲在阿里雲OSS中的Object
     *
     * @param string $sourceBuckt 複製的源Bucket
     * @param string $sourceKey - 複製的的源Object的Key
     * @param string $destBucket - 複製的目的Bucket
     * @param string $destKey - 複製的目的Object的Key
     * @return Models\CopyObjectResult
     */
    public function copyObject($sourceBuckt, $sourceKey, $destBucket, $destKey)
    {
        $oss = new OSS(true); // 上傳文件使用內網，免流量費

        return $oss->ossClient->copyObject($sourceBuckt, $sourceKey, $destBucket, $destKey);
    }

    /**
     * 移動存儲在阿里雲OSS中的Object
     *
     * @param string $sourceBuckt 複製的源Bucket
     * @param string $sourceKey - 複製的的源Object的Key
     * @param string $destBucket - 複製的目的Bucket
     * @param string $destKey - 複製的目的Object的Key
     * @return Models\CopyObjectResult
     */
    public function moveObject($sourceBuckt, $sourceKey, $destBucket, $destKey)
    {
        $oss = new OSS(true); // 上傳文件使用內網，免流量費

        return $oss->ossClient->moveObject($sourceBuckt, $sourceKey, $destBucket, $destKey);
    }

    public static function getUrl($ossKey)
    {
        $oss = new OSS();
        $oss->ossClient->setBucket(config('alioss.BucketName'));
        return $oss->ossClient->getUrl($ossKey, new \DateTime("+1 day"));
    }

    public static function createBucket($bucketName)
    {
        $oss = new OSS();
        return $oss->ossClient->createBucket($bucketName);
    }

    public static function getAllObjectKey($bucketName)
    {
        $oss = new OSS();
        return $oss->ossClient->getAllObjectKey($bucketName);
    }

    /**
     * 獲取指定Object的元信息
     *
     * @param  string $bucketName 源Bucket名稱
     * @param  string $key 存儲的key（文件路徑和文件名）
     * @return object 元信息
     */
    public static function getObjectMeta($bucketName, $osskey)
    {
        $oss = new OSS();
        return $oss->ossClient->getObjectMeta($bucketName, $osskey);
    }

}

使用

首先引入命名空間 use App\Services\OSS;, 在 Laravel 5.1 中使用方法以下

// 獲取表單提交的圖片
$pic = $request->file('pic');
// 判斷圖片有效性
if (!$pic->isValid()) {  
   return back()->withErrors('上傳圖片無效..');
}
// 獲取圖片在臨時文件中的地址
$pic = $pic->getRealPath();
// 製做文件名
$key = time() . rand(10000, 99999999) . '.jpg';
//阿里 OSS 圖片上傳
$result = OSS::upload($key, $pic);
if ($result) {  
   // success
} else {
   // fail
}

注意: 若是你上傳長時間沒反應的話, 說明你上傳使用的是內網, 你得改爲外網上傳, 找到 Service/oss.php 裏面的 upload 方法, 將 $oss = new OSS(true); true 改成 false, 上傳程序便可成功!

附上其餘使用方法

OSS::upload('文件名', '本地路徑'); // 上傳一個文件

echo OSS::getUrl('某個文件的名稱'); // 打印出某個文件的外網連接

OSS::createBucket('一個字符串'); // 新增一個 Bucket。注意，Bucket 名稱具備全局惟一性，也就是說跟其餘人的 Bucket 名稱也不能相同。

OSS::getAllObjectKey('某個 Bucket 名稱'); // 獲取該 Bucket 中全部文件的文件名，返回 Array。

原文出處