管理存储空间

存储空间（Bucket）是对象（Object）的容器，对象必须隶属于某个存储空间。

以下场景的完整代码请参见 GitHub。

新建存储空间

您可以使用$ossClient->createBucket新建存储空间，代码如下：

<?php
/**
 * 创建存储空间
 * ACL 指的是Bucket的访问控制权限，有三种，私有读写、公共读私有写、公共读写。
 * 私有读写指的是只有Bucket的拥有者或授权用户才有权限操作。
 * 三种权限分别对应OssClient::OSS_ACL_TYPE_PRIVATE
 *               OssClient::OSS_ACL_TYPE_PUBLIC_READ
 *               OssClient::OSS_ACL_TYPE_PUBLIC_READ_WRITE
 * 三种存储类型分别对应OssClient::OSS_STORAGE_STANDARD
 *                   OssClient::OSS_STORAGE_IA
 *                   OssClient::OSS_STORAGE_ARCHIVE
 * @param OssClient $ossClient OSSClient实例
 * @param string    $bucket 要创建的Bucket名字
 * @return null
 */
function createBucket($ossClient, $bucket)
{
    try {
        $options = array(
            OssClient::OSS_STORAGE => OssClient::OSS_STORAGE_STANDARD
        );
        //$options参数是可选的
        //Bucket名称是全局唯一的，所以您需要保证Bucket名称未被使用。
        $ossClient->createBucket($bucket, OssClient::OSS_ACL_TYPE_PRIVATE, $options);
    } catch (OssException $e) {
        printf(__FUNCTION__ . ": FAILED\n");
        printf($e->getMessage() . "\n");
        return;
    }
    print(__FUNCTION__ . ": OK" . "\n");
}

关于Bucket命名规范，请参见基本概念中的 命名规范。

判断存储空间是否存在

您可以使用$ossClient->doesBucketExist判断存储空间是否存在，代码如下：

/**
 *  判断Bucket是否存在
 *
 * @param OssClient $ossClient OssClient实例
 * @param string $bucket 存储空间名称
 */
function doesBucketExist($ossClient, $bucket)
{
    try {
        $res = $ossClient->doesBucketExist($bucket);
    } catch (OssException $e) {
        printf(__FUNCTION__ . ": FAILED\n");
        printf($e->getMessage() . "\n");
        return;
    }
    if ($res === true) {
        print(__FUNCTION__ . ": OK" . "\n");
    } else {
        print(__FUNCTION__ . ": FAILED" . "\n");
    }
}

列举存储空间

您可以使用$ossClient->listBuckets列举存储空间，代码如下：

<?php
/**
 * 列举Bucket
 *
 * @param OssClient $ossClient OssClient实例
 * @return null
 */
function listBuckets($ossClient)
{
    $bucketList = null;
    try{
        $bucketListInfo = $ossClient->listBuckets();
    } catch(OssException $e) {
        printf(__FUNCTION__ . ": FAILED\n");
        printf($e->getMessage() . "\n");
        return;
    }
    $bucketList = $bucketListInfo->getBucketList();
    foreach($bucketList as $bucket) {
        print($bucket->getLocation() . "\t" . $bucket->getName() . "\t" . $bucket->getCreatedate() . "\n");
    }
}

删除存储空间

删除存储空间之前，必须先删除存储空间下的所有文件、分片上传产生的碎片、LiveChannel。

您可以使用$ossClient->deleteBucket删除存储空间，代码如下:

<?php
/**
 * 删除存储空间
 *
 * @param OssClient $ossClient OSSClient实例
 * @param string    $bucket 待删除的存储空间名称
 * @return null
 */
function deleteBucket($ossClient, $bucket)
{
    try{
        $ossClient->deleteBucket($bucket);
    } catch(OssException $e) {
        printf(__FUNCTION__ . ": FAILED\n");
        printf($e->getMessage() . "\n");
        return;
    }
    print(__FUNCTION__ . ": OK" . "\n");
}

设置存储空间的访问权限

存储空间有三种访问权限（ACL）：

您可以使用$ossClient->putBucketAcl设置存储空间的访问权限，代码如下：

<?php
/**
 * 设置Bucket的ACL配置
 *
 * @param OssClient $ossClient OssClient实例
 * @param string $bucket 存储空间名称
 * @return null
 */
function putBucketAcl($ossClient, $bucket)
{
    $acl = OssClient::OSS_ACL_TYPE_PRIVATE;
    try {
        $ossClient->putBucketAcl($bucket, $acl);
    } catch (OssException $e) {
        printf(__FUNCTION__ . ": FAILED\n");
        printf($e->getMessage() . "\n");
        return;
    }
    print(__FUNCTION__ . ": OK" . "\n");
}

以上操作只有该存储空间的创建者有权限执行。

存储空间权限详情请参见 权限控制。

获取存储空间的访问权限

您可以使用$ossClient->getBucketAcl获取存储空间的访问权限，代码如下：

<?php
/**
 * 获取Bucket的ACL配置
 *
 * @param OssClient $ossClient OssClient实例
 * @param string $bucket 存储空间名称
 * @return null
 */
function getBucketAcl($ossClient, $bucket)
{
    try {
        $res = $ossClient->getBucketAcl($bucket);
    } catch (OssException $e) {
        printf(__FUNCTION__ . ": FAILED\n");
        printf($e->getMessage() . "\n");
        return;
    }
    print(__FUNCTION__ . ": OK" . "\n");
    print('acl: ' . $res);
}

获取存储空间所属地域

Region 表示 OSS 数据中心所在的地域，物理位置。您可以根据费用、请求来源等综合选择数据存储的 Region。一般来说，距离越近的 Region 访问速度越快。详情请参见 Region。

您可以使用$ossClient->getBucketLocation获取存储空间的所属地域，代码如下：

/**
 * 获取Bucket所属地域
 *
 * @param OssClient $ossClient OssClient实例
 * @param string $bucket 存储空间名称
 * @return null
 */
function getBucketLocation($ossClient, $bucket)
{
    try {
        $Regions = $ossClient->getBucketLocation($bucket);
    } catch (OssException $e) {
        printf(__FUNCTION__ . ": FAILED\n");
        printf($e->getMessage() . "\n");
        return;
    }
    print(__FUNCTION__ . ": OK" . "\n");
    var_dump($Regions);
}

获取存储空间元信息

您可以使用$ossClient->getBucketMeta获取存储空间元信息（Meta），代码如下：

/**
 * 获取Bucket Meta
 *
 * @param OssClient $ossClient OssClient实例
 * @param string $bucket 存储空间名称
 * @return null
 */
function getBucketMeta($ossClient, $bucket)
{
    try {
        $Metas = $ossClient->getBucketMeta($bucket);
    } catch (OssException $e) {
        printf(__FUNCTION__ . ": FAILED\n");
        printf($e->getMessage() . "\n");
        return;
    }
    print(__FUNCTION__ . ": OK" . "\n");
    var_dump($Metas);
}