使用AWS SDK for PHP版本 3 的 Amazon S3 多區域用戶端 - AWS SDK for PHP
基本使用值區區域快取

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

使用AWS SDK for PHP版本 3 的 Amazon S3 多區域用戶端

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

基本使用

無論是使用標準 S3 用戶端還是多區域對應用戶端，Amazon S3 用戶端的基本使用模式都相同。指令層級唯一的用法差異是可以使用@region輸入參數指定「AWS區域」(Region)。

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

值區區域快取

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),
    ],
]);