文件上传OSS三部曲(一)

:-}

对象存储(Object Storage Service,简称OSS),是阿里云对外提供的海量、安全和高可靠的云存储服务。RESTful API的平台无关性,容量和处理能力的弹性扩展,按实际容量付费真正使您专注于核心业务。

第一步,给大家普及下OSS大法好

___     __    _                                    ____    _____   _____

/ | / / () __ / \ / __/ / _/
/ /| | / / / / / / / / / / / / /
\ / / / / _ \ __ \
/ __
| / / / / / // / / // / / / / / / // / __/ / / /
/
/ ||// /_/ \
, / _,/ // // __/ /__/ //
/
/














































对象存储 OSS 自建服务器存储

可靠性

服务可用性不低于99.9%
规模自动扩展,不影响对外服务;
数据持久性不低于99.99999999%。数据自动多重冗余备份
受限于硬件可靠性,易出问题,一旦出现磁盘坏道,容易出现不可逆转的数据丢失。
人工数据恢复困难、耗时、耗力。

安全

提供企业级多层次安全防护,多用户资源隔离机制;支持跨区域复制、异地容灾机制
提供多种鉴权和授权机制及白名单、防盗链、主子账号功能
清洗和黑洞设备需要另外购买,价格昂贵
安全机制需要单独实现,开发和维护成本高

成本

高性价比最低只需要0.14/GB/月
多线BGP骨干网络,无带宽限制,上行流量免费
无需运维人员与托管费用,0成本运维
一次性投入高,资源利用率很低
存储受硬盘容量限制,需人工扩容
单线或双线接入速度慢,有带宽限制,峰值时期需人工扩容
需专人运维,成本高

数据处理能力

提供图片处理、音视频转码、内容加速分发、鉴黄服务、归档服务等多种数据增值服务,并不断丰富中 需要额外采购,单独部署



OSS是什么? 它相对自建服务器存储优势在哪里? 我们怎么使用OSS?
一些详细深入的介绍,可见阿里云官网(在看完本文可以初步使用后,你再去深入了解,现在不要走吖吖吖)。Touch me
环境:
在lnmp环境下基于laravel5.1LTS框架。当然,该组件支持php任何框架。

安装:

composer require "johnlui/aliyun-oss"      

配置:
此处可参考作者推荐配置方式,详情请点击Touch me
此处把composer链接引用过来,并贴上部分aliyunoss组件文章的部分代码,是为了让初学者不需要页面切换,只需要看一篇教程,就可以学到怎样使用OSS,增强可读性。
构建 Service 文件:
新建 app/services/OSS.php:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
<?php
namespace App\Services;
use JohnLui\AliyunOSS\AliyunOSS;
use Config;
class OSS {
private $ossClient;
public function __construct($isInternal = false)
{
$serverAddress = $isInternal ? Config::get('app.ossServerInternal') : Config::get('app.ossServer');
$this->ossClient = AliyunOSS::boot(
$serverAddress,
Config::get('app.AccessKeyId'),
Config::get('app.AccessKeySecret')
);
}
public static function upload($ossKey, $filePath)
{
$oss = new OSS(true); // 上传文件使用内网,免流量费
$oss->ossClient->setBucket('你的 bucket 名称');
return $oss->ossClient->uploadFile($ossKey, $filePath);
}
/**
* 直接把变量内容上传到oss
* @param $osskey
* @param $content
*/
public static function uploadContent($osskey,$content)
{
$oss = new OSS(true); // 上传文件使用内网,免流量费
$oss->ossClient->setBucket('你的 bucket 名称');
return $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);
}
}

放入自动加载:
遵循 psr-0 的项目(如Laravel 4、CodeIgniter、TinyLara)中:
在 composer.json 中 autoload -> classmap 处增加配置:

1
2
3
4
5
"autoload": {
"classmap": [
"app/services"
]
}

然后运行 composer dump-autoload
遵循 psr-4 的项目(如 Laravel 5、Symfony)中:
无需配置,保证目录 App/Services 和命名空间 namespace App\Services; 一致即可自动加载。

注意:我们使用的laravel框架符合psr-4代码规范,所以这一步可省略。

增加相关配置
作者建议在 app/config/app.php 中增加配置,本人建议在app/config 下面新建一个 alioss.php 文件然后在添加配置:

1
2
3
4
5
6
7
8
<?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
];

根据laravel的生命周期可知,项目会首先加载app/config目录下文件,新建一个alioss.php便于和其他组件区分管理。
要去.env文件去配置。
注意
这里有一个大坑, 粗心的朋友一般不会发现, 在填写外网和公网配置的时候, 有的朋友直接在 OSS 管理控制台中把外网和内网一长串的链接复制走, 如下图:
坑!坑!坑!
在这个组件中, 桶名称是需要额外填写的, 所以外网和内网哪儿, 只需要填写桶名后面的内容, 如图:
坑!坑!坑!
再有一点是填写外网和内网的时候需要加上 http:// 协议, 不然后面出错你又得掉坑半天出不来, 最终配置信息如下图:
坑!坑!坑!

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
use App\Services\OSS;
// 上传一个文件
OSS::upload('文件名', '本地路径');
// 打印出某个文件的外网链接
echo OSS::getUrl('某个文件的名称');
// 新增一个 Bucket。注意,Bucket 名称具有全局唯一性,也就是说跟其他人的 Bucket 名称也不能相同。
OSS::createBucket('一个字符串');
// 获取该 Bucket 中所有文件的文件名,返回 Array。
OSS::getAllObjectKey('某个 Bucket 名称');
// 指定 options 如:Content-Type 类型
OSS::upload('文件名', '文件路径', [
'ContentType' => 'application/pdf',
// ...
])

实际使用:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
public function store(Request $request)
{
$input=$request->except('_token');
// dd($input);
// 获取表单提交的图片
$pic = $request->file('picture_url');
// 判断图片有效性
// dd($pic);
//如果有上传图片
if(!empty($pic)){
if (!$pic->isValid()) {
return back()->withErrors('上传图片无效..');
}else{
//获取后缀名
$titles = $pic->getClientOriginalExtension();
// 获取图片在临时文件中的地址
$picpath = $pic->getRealPath();
// 制作文件名
$key = time() . rand(10000, 99999999) . '.'.$titles;
//阿里 OSS 图片上传
$result = OSS::upload('news/'.$key, $picpath);
if (!$result) return back()->withErrors('上传图片失败..');
$input['picture_url']=env('ALIOSS_ACCESS','http://weiyuyan.oss-cn-beijing.aliyuncs.com/').'news/'.$key;
}
}

附录:
官方其他的一些使用指南Touch Me

Thanks