快速入门

基本类

Mss\S3\S3Client: MSS客户端类,用户通过S3Client的实例调用接口

创建存储空间

您可以按照下面的代码新建一个Bucket:

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,
        'key'    => $accessKeyId,
        'secret' => $accessKeySecret,]);

$mssClient->createBucket(array('Bucket' => $bucket));

上传文件

文件(Object)是MSS中的最基本数据单元,您可以把它简单的理解为文件,用下面的代码可以实现上传:

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

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

$mssClient = Mss\S3\S3Client::factory([
        'endpoint' => $endpoint,
        'key'    => $accessKeyId,
        'secret' => $accessKeySecret,]);

$mssClient->putObject(array(
        'Bucket' = > $bucket,
        'Key' => $object,
        'Body' => $content));

下载文件

上传文件后,可以读取它的的内容,以下代码获取Object的文本内容:

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

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

$mssClient = Mss\S3\S3Client::factory([
        'endpoint' => $endpoint,
        'key'    => $accessKeyId,
        'secret' => $accessKeySecret,]);

$result = $mssClient->getObject(array(
        'Bucket' => $bucket,
        'Key' = > $object));
$content = $result['Body']
print("object content=" . $content)

列举文件

当完成上传文件操作后,可能需要查看存储空间下包含哪些文件,以下代码展示如何列举Bucket下的文件:

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,
        'key'    => $accessKeyId,
        'secret' => $accessKeySecret,]);

$iterator = $mssClient->getIterator('ListObjects', array('Bucket' => $bucket));

foreach ($iterator as $object) {
    echo $object['Key'] . "\n";
}

删除文件

以下代码可以删除指定Bucket下的指定的文件(Object):

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

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

$mssClient = Mss\S3\S3Client::factory([
        'endpoint' => $endpoint,
        'key'    => $accessKeyId,
        'secret' => $accessKeySecret,]);

$mssClient->deleteObject(array(
        'Bucket' => $bucket,
        'Key' => $object);