Laravel 运用 OSS

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 热门」公众号,带你了解技术圈内热门新鲜事!

file

本作品采用《CC 协议》,转载必须注明作者和本文链接
感谢关注「GitHub 热门」公众号
附言 1  ·  6年前

使用集成 Laravel 官方驱动 oss 扩展包 iidestiny/laravel-filesystem-oss

本帖由系统于 8年前 自动加精
Destiny
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
讨论数量: 55

哎,真心,远离阿里,保平安。

8年前 评论
Destiny

@JellyBool .... 阿里和七牛应该是用得最多的吧... 有啥坑..

8年前 评论
Destiny

@airycanon 我只是给出了几个比较坑人的地方!原 GitHub 地址已给出,没有抄袭哦!

8年前 评论
Destiny
8年前 评论

对于 Laravel 可以使用 filesystem 扩展 Storage。

8年前 评论
幽弥狂

@ChinaGNU 你是兄弟连几期的?

8年前 评论
Destiny

@xhh110 嗯,124 期的,你呢?

8年前 评论
幽弥狂

@ChinaGNU 106 的 可惜我觉得还没你会的多呢。。。你的网站模板用的是啥??

8年前 评论
Destiny

@xhh110 嗯嗯,我用的 ghost, nodejs 后台

8年前 评论
幽弥狂

@ChinaGNU 好的

8年前 评论

会占用大量的服务器带宽,推荐使用 WEB 直传,服务器签名回调

8年前 评论
Destiny

@liuwantao 这是把官网的 SDK 封装成简单的调用方法.

8年前 评论

这个包确实有一些坑,我用的时候也是打了好几个补丁过去,现在终于让这个包支持自定义 ContentType 一类的属性了,否则都是默认的二进制文件,在 CDN 的时候容易出不少的问题。

8年前 评论
Destiny

@khsing 对, 我也遇到这个问题要设置 MIME 类型, 设置不了,太坑了。

8年前 评论

@ChinaGNU 哈哈,不过我已经把这个坑给填上了 https://github.com/johnlui/AliyunOSS/pull/...

8年前 评论

@khsing 是的,这个之前封装也太扯淡了,都不能设置 ContentType 了,简直了

8年前 评论

这个 封装里面,关于 aliyun oss 的源码,不是通过 composer 加载的,而是直接写死的。拷贝了源码。

8年前 评论
Destiny

@dryyun 哦??

8年前 评论

@ChinaGNU 我说错了什么了?

8年前 评论
Destiny

@dryyun 没。。。

8年前 评论
朕略显ぼうっと萌

为什么不用官方的进行自我封装一个?

8年前 评论

Class 'JohnLui\AliyunOSS\AliyunOSS' not found

8年前 评论
Destiny

@Qianud 引入了命名空间吗?亲

8年前 评论

引用了 是不是直接按照上面的步骤走? 也不用配置 直接 composer 完了以后就按照那个引入? 但我这边报错 。

8年前 评论
Destiny

你再按照流程仔细走走,看看是不是哪里忽略了,

8年前 评论
Destiny
8年前 评论
幽弥狂

你的 boot 方法哪里缺少参数吧?

7年前 评论
Destiny

@xhh110 什么参数?

7年前 评论
幽弥狂

@Destiny AliOss 参数是五个,你的里面只有三个,我这改为 false

file

仍然为

file

7年前 评论
Mr丶L

file我也遇到这种情况了,请问怎么解决啊,完全是按照你写的这个弄下来的

7年前 评论
Destiny

@Mr 丶 L 可以看一下作者的 GitHub 地址的最新文档,应该是作者有更新了。不好意思哈。。?

7年前 评论
Destiny

@Destiny 文章是没问题的,我是亲自试验后才写的。?

7年前 评论

大哥我也是兄弟连的刚毕业 现在在弄这个 oss 遇到点问题能指教下吗
我 QQ 号 897935247 看到加我下谢谢

7年前 评论

炸了 你这个有问题啊。

7年前 评论
Destiny
7年前 评论
Destiny
7年前 评论

最后还是按照你这个弄出来出错的原因还是 参数的问题。

7年前 评论
Destiny

@Asa_c 嗯嗯,参数问题很坑的。基本上都是参数坑

7年前 评论

@Destiny 感谢大哥分享~还有一个坑 就是命名空间的问题。 大家要注意了。

7年前 评论

OSS::getUrl() 这里还有一个参数 设置过期时间 不然默认过期时间为 3600s 用于访问头像不是特别友好 或者在控制台将 bucket 权限改为公共读。根据外网连接加图片名 生成访问连接。

7年前 评论

@Destiny 大哥 我想问下这个包 能做音频转码嘛? mp3 转 amr 格式

6年前 评论
1234561212122121121212

@zhaopeng0718 转码用 ffmpeg

6年前 评论

@1234561212122121121212 我下载那个了 转不了 AMR 格式・・我需要把 MP3 的转成 amr 还有别的办法么 大哥

6年前 评论
1234561212122121121212

@zhaopeng0718 那我就不知道了,我是用 amr 转 MP3

6年前 评论

@Destiny 试了好几个 OSS 相关的库。但是没用过博主正文中提到的这个。因为不支持 Storage::xxx() 写法。最后也选择了 jacobcyl/ali-oss-storage
但是这个库好像也有问题,就是把 isCName 设置为 true 的时候就喜欢报错,没具体提示。

OSS \ Core \ OssException
: RequestId: 5C07311E44ABAB2B12A4EFFB

请教下,大家现在一般对于阿里云的 OSS,现在都什么哪个库来操作。

6年前 评论
Destiny

@keer

"jacobcyl/ali-oss-storage": "^2.1",

也正常使用着,多调试调试吧。

6年前 评论

@Destiny 谢谢。 刚调了下发现确实有 bug。只要配 isCName 为 true 就有问题。看作者也确认了,不知道啥时候发包。只能自己先改了。

6年前 评论

删除 传的参数是什么

6年前 评论

jacobcyl/ali-oss-storage":"^2.1 . 这个怎么上传到阿里云呢?? 只有看到 storge .... 文档上好像没有写

6年前 评论
Destiny
6年前 评论

为什么不直接用 ossfs 挂载到本地呢,更简单。

4年前 评论

都 4 年了,源仓库还有坑还没填 :joy:

4年前 评论