本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

结合使用 S3 接入点 ARN 与 AWS SDK for PHP 版本 3

S3 引入了接入点，这是与 S3 存储桶交互的一种新方式。接入点上可以应用唯一的策略和配置，而不是直接应用到存储桶。通过 AWS SDK for PHP，您可以在存储桶字段中使用接入点 ARN 进行 API 操作，而不是明确指定存储桶名称。有关 S3 接入点和 ARN 工作原理的更多详细信息，可在此处找到。以下示例演示如何：

的所有示例代码都可以在此AWS SDK for PHP处找到 GitHub。

凭证

运行示例代码之前，请配置您的 AWS 凭证，如 凭证 中所述。然后导入 AWS SDK for PHP，如 基本用法 中所述。

导入

require 'vendor/autoload.php';

use Aws\S3\S3Client;

获取对象

首先创建用于指定 AWS 区域和版本的 AWS.S3 客户端服务。然后 getObject 使用您的密钥并在 Bucket 字段中使用 S3 接入点 ARN 调用该方法，以从与该接入点关联的存储桶中获取对象。

示例代码

$s3 = new S3Client([
    'version'     => 'latest',
    'region'      => 'us-west-2',
]);
$result = $s3->getObject([
    'Bucket' => 'arn:aws:s3:us-west-2:123456789012:accesspoint:endpoint-name',
    'Key' => 'MyKey'
]);

在存储桶中放置对象

首先创建用于指定 AWS 区域和版本的 AWS.S3 客户端服务。然后使用所需的密钥、正文或源文件并在 Bucket 字段中使用 S3 接入点 ARN 调用 putObject 方法，这会将对象放入与该接入点关联的存储桶中。

示例代码

$s3 = new S3Client([
    'version'     => 'latest',
    'region'      => 'us-west-2',
]);
$result = $s3->putObject([
    'Bucket' => 'arn:aws:s3:us-west-2:123456789012:accesspoint:endpoint-name',
    'Key' => 'MyKey',
    'Body' => 'MyBody'
]);

将 S3 客户端配置为使用 ARN 区域而不是客户端区域

在 S3 客户端操作中使用 S3 接入点 ARN 时，默认情况下，客户端将确保 ARN 区域与客户端区域匹配，如果不匹配则引发异常。通过将 use_arn_region 配置选项设置为 true，可将此行为更改为接受 ARN 区域而不是客户端区域。默认情况下，该选项设置为 false。

示例代码

$s3 = new S3Client([
    'version'        => 'latest',
    'region'         => 'us-west-2',
    'use_arn_region' => true
]);

客户端还将按以下优先顺序检查环境变量和配置文件选项：

export AWS_S3_USE_ARN_REGION=true

[default]
s3_use_arn_region = true