下载文件(Object)时,可以指定一个或多个限定条件。满足限定条件则下载,条件不满足则返回错误且不会触发下载行为。限定条件下载既可以将OSS文件下载到本地内存,也可以下载到本地文件。
注意事项
本文以华东1(杭州)外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系,请参见OSS访问域名、数据中心、开放端口。
本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient,请参见新建OssClient。
要限定条件下载,您必须有
oss:GetObject
权限。具体操作,请参见为RAM用户授权自定义的权限策略。
限定条件
下表列举了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\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// 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****"',
)
);
$config = array(
"provider" => $provider,
"endpoint" => $endpoint,
"signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
"region"=> "cn-hangzhou"
);
$ossClient = new OssClient($config);
// 下载至本地内存。
$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\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// 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
)
);
$config = array(
"provider" => $provider,
"endpoint" => $endpoint,
"signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
"region"=> "cn-hangzhou"
);
$ossClient = new OssClient($config);
$ossClient->getObject($bucket, $object, $options);
} catch(OssException $e) {
printf(__FUNCTION__ . ": FAILED\n");
printf($e->getMessage() . "\n");
return;
}