2017 © Pedro Peláez
 

library mss-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

image

mss/mss-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

  • Friday, January 12, 2018
  • by thomrou
  • Repository
  • 9 Watchers
  • 7 Stars
  • 66 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 6 Forks
  • 0 Open issues
  • 1 Versions
  • 0 % Grown

The README.md

MSS(Meituan Storage Service) SDK for PHP

This is MSS SDK for PHP., (*1)

Introduction

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, (*2)

Installation

# Requirement
PHP >= 5.5.0

# 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

Quick Start

    <?php
    require '/path/to/mss.phar';
    # e.g
    # require __DIR__ . '/mssapi_php/build/artifacts/mss.phar';

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

    $bucketName = 'testphp';

    # create bucket
    $s3->createBucket(array('Bucket' => $bucketName));

    # list buckets
    echo "S3::listBuckets(): ".print_r($s3->listBuckets(), 1)."\n";

    # get bucket
    $contents = $s3->getBucket(array('Bucket' => $bucketName));

    # put object
    # make sure bucket exist
    $key1 = 'file1';
    $s3->putObject(array(
        'Bucket' => $bucketName,
        'Key' => $key1,
        'Body' => 'hello'
    ));

    # put object, upload local file
    $key2 = 'file2';
    $localFile = 'filename'; # the file name that you want to save at local
    $s3->putObject(array(
        'Bucket' => $bucketName,
        'Key' => $key2,
        'SourceFile' => $localFile
    ));

    # delete object
    $s3->deleteObject(array('Bucket' => $bucketName, 'Key' => $key1));
    $s3->deleteObject(array('Bucket' => $bucketName, 'Key' => $key2));

    # delete bucket
    $s3->deleteBucket(array('Bucket' => $bucketName));

    # 当生成对象s3的时候,若指定了参数image_endpoint, 则对象s3还可以进行图像处理:包括获取处理后的图片和生成pre signed url
    $bucketName = 'image-bucket'; # image-bucket已经存在
    $key = "example.jpg@watermark=2&text=bWVpdHVhbnl1bg=="; # example.jpg已经存在
    $s3->getImageObject(array(
        'Bucket' => $bucketName,
        'Key' => $key,
        'SaveAs' => 'watermark.jpg',
    ));

    $timestamp = 1465434602; # need modifyed
    $imageUrl = $s3->getImageObjectUrl($bucketName, $key, $timestamp);
    print "$imageUrl\n";

    print "test completed!\n";

The Versions

12/01 2018

dev-master

9999999-dev http://mtmss.com

AWS SDK for PHP - Use Amazon Web Services in your PHP project

  Sources   Download

Apache-2.0

The Requires

 

The Development Requires

cloud amazon s3 aws sdk dynamodb ec2 glacier