第 3 版中的 Amazon S3 多區域用戶端 適用於 PHP 的 AWS SDK - 適用於 PHP 的 AWS SDK
基本使用儲存貯體區域快取

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

第 3 版中的 Amazon S3 多區域用戶端 適用於 PHP 的 AWS SDK

第 3 適用於 PHP 的 AWS SDK 版提供一般多區域用戶端，可與任何 服務搭配使用。這可讓使用者提供@region輸入參數給任何命令，以指定 AWS 要傳送命令的區域。此外，開發套件為 Amazon S3 提供多區域用戶端，以智慧方式回應特定的 Amazon S3 錯誤，並相應地重新路由命令。這讓使用者能夠使用相同的用戶端來與多個區域溝通。對於 Amazon S3 串流包裝函式第 3 適用於 PHP 的 AWS SDK 版的使用者來說，此功能特別有用，其儲存貯體位於多個區域。

基本使用

無論使用標準 Amazon S3 S3 用戶端的基本使用模式都相同。命令層級的唯一用量差異是可以使用@region輸入參數指定 AWS 區域。

// Create a multi-region S3 client
$s3Client = (new \Aws\Sdk)->createMultiRegionS3(['version' => 'latest']);

// You can also use the client constructor
$s3Client = new \Aws\S3\S3MultiRegionClient([
    'version' => 'latest',
    // Any Region specified while creating the client will be used as the
    // default Region
    'region' => 'us-west-2',
]);

// Get the contents of a bucket
$objects = $s3Client->listObjects(['Bucket' => $bucketName]);

// If you would like to specify the Region to which to send a command, do so
// by providing an @region parameter
$objects = $s3Client->listObjects([
    'Bucket' => $bucketName,
    '@region' => 'eu-west-1',
]);
重要

使用多區域 Amazon S3 用戶端時，您不會遇到任何永久重新導向例外狀況。當命令傳送到錯誤的區域Aws\S3\Exception\PermanentRedirectException時，標準 Amazon S3 用戶端會擲回 的執行個體。多區域用戶端將重新配發命令到正確區域。

儲存貯體區域快取

Amazon S3 多區域用戶端會維護指定儲存貯體所在 AWS 區域的內部快取。在預設情況下，每個用戶端都有自己的記憶體內快取。若要在用戶端或程序之間共用快取，請向您的多區域用戶端提供 Aws\CacheInterface 的執行個體做為 bucket_region_cache 選項。

use Aws\DoctrineCacheAdapter;
use Aws\Sdk;
use Doctrine\Common\Cache\ApcuCache;

$sdk = new Aws\Sdk([
    'version' => 'latest',
    'region' => 'us-west-2',
    'S3' => [
        'bucket_region_cache' => new DoctrineCacheAdapter(new ApcuCache),
    ],
]);