下载文件(Object)时,可以指定一个或多个限定条件。满足限定条件则下载,条件不满足则返回错误且不会触发下载行为。限定条件下载既可以将OSS文件下载到本地内存,也可以下载到本地文件。

限定条件

下表列举了OSS支持的多种限定条件。其中If-Modified-Since与If-Unmodified-Since可以同时使用,If-Match与If-None-Match也可以同时使用。

参数 描述 设置方法
If-Modified-Since 如果实际修改时间晚于指定的时间,则正常传输文件,否则返回错误(304 Not modified)。 OssClient::OSS_IF_MODIFIED_SINCE
If-Unmodified-Since 如果实际修改时间早于或者等于指定的时间,则正常传输文件,否则返回错误(412 Precondition failed)。 OssClient::OSS_IF_UNMODIFIED_SINCE
If-Match 如果OSS文件的ETag与指定的ETag匹配,则正常传输文件,否则返回错误(412 Precondition failed)。
说明 ETag可以通过$ossClient->getObjectMeta方法获取。
OssClient::OSS_IF_MATCH
If-None-Match 如果OSS文件的ETag与指定的ETag不匹配,则正常传输文件,否则返回错误(304 Not modified)。 OssClient::OSS_IF_NONE_MATCH

限定条件下载至本地内存

以下代码用于下载Object时指定限定条件,并将Object下载至本地内存:

<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}

use OSS\OssClient;

// 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
$accessKeyId = "<yourAccessKeyId>";
$accessKeySecret = "<yourAccessKeySecret>";
// Endpoint以杭州为例,其它Region请按实际情况填写。
$endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 填写Bucket名称。
$bucket= "<yourBucketName>";
// 填写Object名称。Object名称为不包含Bucket名称在内的Object的完整路径,例如exampledir/exampleobject.txt。
$object = "<yourObjectName>";

try{
    $options = array(
        OssClient::OSS_HEADERS => array(          
          // 指定下载实际修改时间晚于Fri, 9 Apr 2021 14:47:53 GMT的Object。
          OssClient::OSS_IF_MODIFIED_SINCE => "Fri, 9 Apr 2021 14:47:53 GMT",
          // 指定下载实际修改时间早于或者等于Wed, 13 Oct 2021 14:47:53 GMT的Object。
          OssClient::OSS_IF_UNMODIFIED_SINCE => "Fri, 13 Oct 2021 14:47:53 GMT",
          // 指定下载与传入的ETag值不匹配的Object。
          OssClient::OSS_IF_NONE_MATCH => '"5B3C1A2E0563E1B002CC607C****"',
          // 指定下载与传入的ETag值匹配的Object。
          OssClient::OSS_IF_MATCH => '"fba9dede5f27731c9771645a3986****"',
        )

    );

    $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    // 下载至本地内存。
    $content = $ossClient->getObject($bucket, $object, $options);
} catch(OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print ($content);
print(__FUNCTION__ . ": OK" . "\n");

限定条件下载至本地文件

以下代码用于下载Object时指定限定条件,并将Object下载至本地文件:

<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}

use OSS\OssClient;

// 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
$accessKeyId = "<yourAccessKeyId>";
$accessKeySecret = "<yourAccessKeySecret>";
// Endpoint以杭州为例,其它Region请按实际情况填写。
$endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 填写Bucket名称。
$bucket= "<yourBucketName>";
// 填写Object名称。Object名称为不包含Bucket名称在内的Object的完整路径,例如exampledir/exampleobject.txt。
$object = "<yourObjectName>";
// 填写本地文件的完整路径。例如D:\\localpath\\examplefile.txt。
$localfile = "<yourLocalFile>";

try{
    $options = array(
        OssClient::OSS_HEADERS => array(          
           // 指定下载实际修改时间晚于Fri, 9 Apr 2021 14:47:53 GMT的Object。
          OssClient::OSS_IF_MODIFIED_SINCE => "Fri, 9 Apr 2021 14:47:53 GMT",
          // 指定下载实际修改时间早于或者等于Wed, 13 Oct 2021 14:47:53 GMT的Object。
          OssClient::OSS_IF_UNMODIFIED_SINCE => "Fri, 13 Oct 2021 14:47:53 GMT",
          // 指定下载与传入的ETag值不匹配的Object。
          OssClient::OSS_IF_NONE_MATCH => '"5B3C1A2E0563E1B002CC607C****"',
          // 指定下载与传入的ETag值匹配的Object。
          OssClient::OSS_IF_MATCH => '"fba9dede5f27731c9771645a3986****"',          
          OssClient::OSS_FILE_DOWNLOAD => $localfile
        )

    );

    $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    $ossClient->getObject($bucket, $object, $options);
} catch(OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}