237 lines
12 KiB
PHP
237 lines
12 KiB
PHP
<?php
|
|
namespace Aws\S3;
|
|
|
|
use Aws\CacheInterface;
|
|
use Aws\CommandInterface;
|
|
use Aws\LruArrayCache;
|
|
use Aws\MultiRegionClient as BaseClient;
|
|
use Aws\S3\Exception\PermanentRedirectException;
|
|
use GuzzleHttp\Promise;
|
|
|
|
/**
|
|
* **Amazon Simple Storage Service** multi-region client.
|
|
*
|
|
* @method \Aws\Result abortMultipartUpload(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise abortMultipartUploadAsync(array $args = [])
|
|
* @method \Aws\Result completeMultipartUpload(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise completeMultipartUploadAsync(array $args = [])
|
|
* @method \Aws\Result copyObject(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise copyObjectAsync(array $args = [])
|
|
* @method \Aws\Result createBucket(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise createBucketAsync(array $args = [])
|
|
* @method \Aws\Result createMultipartUpload(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise createMultipartUploadAsync(array $args = [])
|
|
* @method \Aws\Result deleteBucket(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise deleteBucketAsync(array $args = [])
|
|
* @method \Aws\Result deleteBucketCors(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise deleteBucketCorsAsync(array $args = [])
|
|
* @method \Aws\Result deleteBucketLifecycle(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise deleteBucketLifecycleAsync(array $args = [])
|
|
* @method \Aws\Result deleteBucketPolicy(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise deleteBucketPolicyAsync(array $args = [])
|
|
* @method \Aws\Result deleteBucketReplication(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise deleteBucketReplicationAsync(array $args = [])
|
|
* @method \Aws\Result deleteBucketTagging(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise deleteBucketTaggingAsync(array $args = [])
|
|
* @method \Aws\Result deleteBucketWebsite(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise deleteBucketWebsiteAsync(array $args = [])
|
|
* @method \Aws\Result deleteObject(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise deleteObjectAsync(array $args = [])
|
|
* @method \Aws\Result deleteObjects(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise deleteObjectsAsync(array $args = [])
|
|
* @method \Aws\Result getBucketAccelerateConfiguration(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketAccelerateConfigurationAsync(array $args = [])
|
|
* @method \Aws\Result getBucketAcl(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketAclAsync(array $args = [])
|
|
* @method \Aws\Result getBucketCors(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketCorsAsync(array $args = [])
|
|
* @method \Aws\Result getBucketLifecycle(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketLifecycleAsync(array $args = [])
|
|
* @method \Aws\Result getBucketLifecycleConfiguration(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketLifecycleConfigurationAsync(array $args = [])
|
|
* @method \Aws\Result getBucketLocation(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketLocationAsync(array $args = [])
|
|
* @method \Aws\Result getBucketLogging(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketLoggingAsync(array $args = [])
|
|
* @method \Aws\Result getBucketNotification(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketNotificationAsync(array $args = [])
|
|
* @method \Aws\Result getBucketNotificationConfiguration(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketNotificationConfigurationAsync(array $args = [])
|
|
* @method \Aws\Result getBucketPolicy(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketPolicyAsync(array $args = [])
|
|
* @method \Aws\Result getBucketReplication(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketReplicationAsync(array $args = [])
|
|
* @method \Aws\Result getBucketRequestPayment(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketRequestPaymentAsync(array $args = [])
|
|
* @method \Aws\Result getBucketTagging(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketTaggingAsync(array $args = [])
|
|
* @method \Aws\Result getBucketVersioning(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketVersioningAsync(array $args = [])
|
|
* @method \Aws\Result getBucketWebsite(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getBucketWebsiteAsync(array $args = [])
|
|
* @method \Aws\Result getObject(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getObjectAsync(array $args = [])
|
|
* @method \Aws\Result getObjectAcl(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getObjectAclAsync(array $args = [])
|
|
* @method \Aws\Result getObjectTorrent(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise getObjectTorrentAsync(array $args = [])
|
|
* @method \Aws\Result headBucket(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise headBucketAsync(array $args = [])
|
|
* @method \Aws\Result headObject(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise headObjectAsync(array $args = [])
|
|
* @method \Aws\Result listBuckets(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise listBucketsAsync(array $args = [])
|
|
* @method \Aws\Result listMultipartUploads(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise listMultipartUploadsAsync(array $args = [])
|
|
* @method \Aws\Result listObjectVersions(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise listObjectVersionsAsync(array $args = [])
|
|
* @method \Aws\Result listObjects(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise listObjectsAsync(array $args = [])
|
|
* @method \Aws\Result listObjectsV2(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise listObjectsV2Async(array $args = [])
|
|
* @method \Aws\Result listParts(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise listPartsAsync(array $args = [])
|
|
* @method \Aws\Result putBucketAccelerateConfiguration(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketAccelerateConfigurationAsync(array $args = [])
|
|
* @method \Aws\Result putBucketAcl(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketAclAsync(array $args = [])
|
|
* @method \Aws\Result putBucketCors(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketCorsAsync(array $args = [])
|
|
* @method \Aws\Result putBucketLifecycle(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketLifecycleAsync(array $args = [])
|
|
* @method \Aws\Result putBucketLifecycleConfiguration(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketLifecycleConfigurationAsync(array $args = [])
|
|
* @method \Aws\Result putBucketLogging(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketLoggingAsync(array $args = [])
|
|
* @method \Aws\Result putBucketNotification(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketNotificationAsync(array $args = [])
|
|
* @method \Aws\Result putBucketNotificationConfiguration(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketNotificationConfigurationAsync(array $args = [])
|
|
* @method \Aws\Result putBucketPolicy(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketPolicyAsync(array $args = [])
|
|
* @method \Aws\Result putBucketReplication(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketReplicationAsync(array $args = [])
|
|
* @method \Aws\Result putBucketRequestPayment(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketRequestPaymentAsync(array $args = [])
|
|
* @method \Aws\Result putBucketTagging(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketTaggingAsync(array $args = [])
|
|
* @method \Aws\Result putBucketVersioning(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketVersioningAsync(array $args = [])
|
|
* @method \Aws\Result putBucketWebsite(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putBucketWebsiteAsync(array $args = [])
|
|
* @method \Aws\Result putObject(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putObjectAsync(array $args = [])
|
|
* @method \Aws\Result putObjectAcl(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise putObjectAclAsync(array $args = [])
|
|
* @method \Aws\Result restoreObject(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise restoreObjectAsync(array $args = [])
|
|
* @method \Aws\Result uploadPart(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise uploadPartAsync(array $args = [])
|
|
* @method \Aws\Result uploadPartCopy(array $args = [])
|
|
* @method \GuzzleHttp\Promise\Promise uploadPartCopyAsync(array $args = [])
|
|
*/
|
|
class S3MultiRegionClient extends BaseClient implements S3ClientInterface
|
|
{
|
|
use S3ClientTrait {
|
|
determineBucketRegionAsync as private lookupBucketRegion;
|
|
}
|
|
|
|
/** @var CacheInterface */
|
|
private $cache;
|
|
|
|
public static function getArguments()
|
|
{
|
|
$args = parent::getArguments();
|
|
$args['region']['default'] = 'us-east-1';
|
|
|
|
return $args + [
|
|
'bucket_region_cache' => [
|
|
'type' => 'config',
|
|
'valid' => [CacheInterface::class],
|
|
'doc' => 'Cache of regions in which given buckets are located.',
|
|
'default' => function () { return new LruArrayCache; },
|
|
],
|
|
];
|
|
}
|
|
|
|
public function __construct(array $args)
|
|
{
|
|
parent::__construct($args);
|
|
$this->cache = $this->getConfig('bucket_region_cache');
|
|
}
|
|
|
|
public function executeAsync(CommandInterface $c)
|
|
{
|
|
return Promise\coroutine(function () use ($c) {
|
|
if ($region = $this->cache->get($this->getCacheKey($c['Bucket']))) {
|
|
$c = $this->getRegionalizedCommand($c, $region);
|
|
}
|
|
|
|
try {
|
|
yield parent::executeAsync($c);
|
|
} catch (PermanentRedirectException $e) {
|
|
if (empty($c['Bucket'])) {
|
|
throw $e;
|
|
}
|
|
$region = (yield $this->lookupBucketRegion($c['Bucket']));
|
|
$this->cache->set($this->getCacheKey($c['Bucket']), $region);
|
|
$c = $this->getRegionalizedCommand($c, $region);
|
|
yield parent::executeAsync($c);
|
|
}
|
|
});
|
|
}
|
|
|
|
public function createPresignedRequest(CommandInterface $command, $expires)
|
|
{
|
|
if (empty($command['Bucket'])) {
|
|
throw new \InvalidArgumentException('The S3\\MultiRegionClient'
|
|
. ' cannot create presigned requests for commands without a'
|
|
. ' specified bucket.');
|
|
}
|
|
|
|
/** @var S3ClientInterface $client */
|
|
$client = $this->getClientFromPool(
|
|
$this->determineBucketRegion($command['Bucket'])
|
|
);
|
|
return $client->createPresignedRequest(
|
|
$client->getCommand($command->getName(), $command->toArray()),
|
|
$expires
|
|
);
|
|
}
|
|
|
|
public function getObjectUrl($bucket, $key)
|
|
{
|
|
/** @var S3Client $regionalClient */
|
|
$regionalClient = $this->getClientFromPool(
|
|
$this->determineBucketRegion($bucket)
|
|
);
|
|
|
|
return $regionalClient->getObjectUrl($bucket, $key);
|
|
}
|
|
|
|
public function determineBucketRegionAsync($bucketName)
|
|
{
|
|
if ($cached = $this->cache->get($this->getCacheKey($bucketName))) {
|
|
return Promise\promise_for($cached);
|
|
}
|
|
|
|
return $this->lookupBucketRegion($bucketName)
|
|
->then(function ($region) use ($bucketName) {
|
|
$this->cache->set($this->getCacheKey($bucketName), $region);
|
|
|
|
return $region;
|
|
});
|
|
}
|
|
|
|
private function getRegionalizedCommand(CommandInterface $command, $region)
|
|
{
|
|
return $this->getClientFromPool($region)
|
|
->getCommand($command->getName(), $command->toArray());
|
|
}
|
|
|
|
private function getCacheKey($bucketName)
|
|
{
|
|
return "aws:s3:{$bucketName}:location";
|
|
}
|
|
}
|