laravel下使用阿里雲oss上傳圖片

本文整理借鑒自 https://lvwenhan.com/laravel/420.html

對小公司而言，使用阿里雲oss比直接買硬盤要划算的多，不管從存儲性價比上還是從網速負載上。最近因為公司的項目有比較大的圖片存儲訪問需求，所以決定使用阿里雲的oss。

在研究了一下以后，擺着不自己造輪子的原則，決定使用AliyunOss,國人laravel高手JohnLui封裝的一個阿里雲oss的操作庫。

AliyunOSS 是阿里雲 OSS 官方 SDK 的 Composer 封裝，支持任何 PHP 項目，包括 Laravel、Symfony、TinyLara 等等。Github 地址：https://github.com/johnlui/AliyunOSS

 

安裝

將以下內容增加到 composer.json：

require: {

    "johnlui/aliyun-oss": "*"

}

然后運行 `composer update。

 

使用（以 Laravel 為例）

構建 Service 文件

新建 `app/services/OSS.php`，內容可參考：OSSExample.php：

<?php
/**
 * Created by PhpStorm.
 * User: Administrator
 * Date: 2016/9/6
 * Time: 10:14
 */
namespace App\Services;

use JohnLui\AliyunOSS\AliyunOSS;

use Config;

class OSS {

    private $ossClient;

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

    // 默認上傳文件使用內網，免流量費
    public static function upload($ossKey, $filePath, $isInternal = true)
    {
        $oss = new OSS($isInternal);
        $oss->ossClient->setBucket('你的Bucket名字');
        $oss->ossClient->uploadFile($ossKey, $filePath);
    }
    /**
     * 直接把變量內容上傳到oss
     * @param $osskey
     * @param $content
     */
    public static function uploadContent($osskey,$content)
    {
        $oss = new OSS(true); // 上傳文件使用內網，免流量費
        $oss->ossClient->setBucket('你的Bucket名字');
        $oss->ossClient->uploadContent($osskey,$content);
    }

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

        return $oss->ossClient->deleteObject('你的Bucket名字', $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('你的Bucket名字');
        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);
    }
}

　　

增加相關配置

在 app/config/oss.php 中增加以下配置：

<?php
/**
 * Created by PhpStorm.
 * User: Administrator
 * Date: 2016/9/6
 * Time: 10:17
 */
return [
    'useInternal' => false,//是否使用OSS內網傳輸來省流量
    'ossServer' => '服務器外網地址', //青島為 http://oss-cn-qingdao.aliyuncs.com
    'ossServerInternal' => '服務器內網地址', //青島為 http://oss-cn-qingdao-internal.aliyuncs.com
    'AccessKeyId' => '阿里雲給的AccessKeyId',
    'AccessKeySecret' => '阿里雲給的AccessKeySecret',
];

　　

使用

use App\Services\OSS;

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

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

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

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

　　

常見問題：

① Undefined index: host

解決方案：https://github.com/johnlui/AliyunOSS/issues/9

② The specified bucket is not valid.

錯誤原因：你們的內外地址肯定是給了http://****.oss-cn-beijing.aliyuncs.com 這里的*是指bucket名字,  然后你們調用方法的時候有傳入了一個bucket的名字, 然后它給你們拼接起來 就變成了http://bucketName.bucketName.oss-cn..........com    

解決方案:在配置文件里面ALIOSS_SERVER=http://oss-cn-beijing.aliyuncs.com   比如這個外網地址前面不要加上 bucket名字

 

項目存在的不足：

目前調用SDK沒有一個狀態值返回，所以不知道上傳是否會存在BUG，過段時間盡量Fork並修改一下。

 

個人建議：

盡量使用laravel自帶的job和queue來完成upload操作。