Laravel 運用 OSS

Destiny發表於2016-09-26
Laravel

2019-01-02 更新：請直接使用更優雅的 oss 元件 iidestiny/laravel-filesystem-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 管理控制檯中把外網和內網一長串的連結複製走, 如下圖:

file

在這個元件中, 桶名稱是需要額外填寫的, 所以外網和內網哪兒, 只需要填寫桶名後面的內容, 如圖:

file

再有一點是填寫外網和內網的時候需要加上 http:// 協議, 不然後面出錯你又得掉坑半天出不來, 最終配置資訊如下圖:

file

構建 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。

可以在上指定 OSSOptions，比如 ContentType 之類的：

$oss = new OSS;
$oss->upload('t5.svg','2676143e4cb25df80e6e84f34fb22058.svg',['ContentType'=>'image/svg+xml'])

PS

原作者 GitHub 專案 : https://github.com/johnlui/AliyunOSS
小弟的技術部落格 : http://aabvip.com

將來的你一定會感謝現在努力的自己！

相關文章