安装和使用

MSS服务介绍

美团云存储服务(Meituan Storage Service, 简称MSS),是美团云对外提供的对象存储服务,其具备高可靠,安全,低成本等特性,并且其API兼容S3。MSS适合存放非结构化的数据,比如图片,视频,文档,备份等。

MSS基本概念介绍

MSS的API兼容S3, 其基本概念也和S3相同,主要包括Object, Bucket, Access Key, Secret Key等。
Object对应一个文件,包括数据和元数据两部分。元数据以key-value的形式构成,它包含一些默认的元数据信息,比如Content-Type, Etag等,用户也可以自定义元数据。
Bucket是object的容器,每个object都必须包含在一个bucket中。用户可以创建任意多个bucket。
Access Key和Secret Key: 用户注册MSS时,系统会给用户分配一对Access Key和Secret Key, 用于标识用户,用户在使用API使用MSS服务时,需要使用这两个Key。请在美团云管理控制台查询AccessKey和SecretKey。

MSS访问域名

mtmss.com

安装

SDK下载

安装环境

  • PHP 5.5+

安装

提供以下两种方式:

  • 源码方式
  • phar方式

源码方式

// Build the phar and zip, under build/artifacts/
curl http://getcomposer.org/installer | php
php composer.phar install
// 修改/etc/php.ini, 设置phar.readonly = Off
make package

// 在代码里引入如下文件:
requre_once '/path/to/mss-sdk/mss.phar';

phar方式

  1. 在发布页面中选择相应的版本,并下载phar文件。

  2. 在代码中引入如下文件:

    require_once '/path/to/mss.phar';

初始化

mss/mssclient是SDK的客户端类,使用者可以通过mssclient提供的接口管理Bucket和Object等。

确定Endpooint

Region中文名称 Region英文名称 外网Endpoint
华北1区 NorthChina1 mtmss.com
华东1区 EastChina1 eastchina1.mtmss.com

新建MssClient

使用mss域名新建MssClient

require '/path/to/mss.phar';

$accessKeyId = "<从MSS获得的AccessKeyId>";
$accessKyeSecret = "<从MSS获得的AccessKeySecret>";
$endpoint = "<选定的MSS数据中心访问域名,例如http://mtmss.com>";
$bucket = "<使用的bucketName,注意命名规范>";

$mssClient = Mss\S3\S3Client::factory([
        'endpoint' => $endpoint,
        'image_endpoint' => 'http://image.mtmss.com', # 可选的
        'key'    => $accessKeyId,
        'secret' => $accessKeySecret,]);