diff options
author | Andrew Dolgov <[email protected]> | 2022-11-23 21:14:33 +0300 |
---|---|---|
committer | Andrew Dolgov <[email protected]> | 2022-11-23 21:14:33 +0300 |
commit | 0c8af4992cb0f7589dcafaad65ada12753c64594 (patch) | |
tree | 18e83d068c3e7dd2499331de977782b382279396 /vendor/aws/aws-sdk-php/src/S3/UseArnRegion |
initial
Diffstat (limited to 'vendor/aws/aws-sdk-php/src/S3/UseArnRegion')
4 files changed, 245 insertions, 0 deletions
diff --git a/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/Configuration.php b/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/Configuration.php new file mode 100644 index 0000000..91277d6 --- /dev/null +++ b/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/Configuration.php @@ -0,0 +1,37 @@ +<?php +namespace Aws\S3\UseArnRegion; + +use Aws; +use Aws\S3\UseArnRegion\Exception\ConfigurationException; + +class Configuration implements ConfigurationInterface +{ + private $useArnRegion; + + public function __construct($useArnRegion) + { + $this->useArnRegion = Aws\boolean_value($useArnRegion); + if (is_null($this->useArnRegion)) { + throw new ConfigurationException("'use_arn_region' config option" + . " must be a boolean value."); + } + } + + /** + * {@inheritdoc} + */ + public function isUseArnRegion() + { + return $this->useArnRegion; + } + + /** + * {@inheritdoc} + */ + public function toArray() + { + return [ + 'use_arn_region' => $this->isUseArnRegion(), + ]; + } +} diff --git a/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/ConfigurationInterface.php b/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/ConfigurationInterface.php new file mode 100644 index 0000000..c7f3b24 --- /dev/null +++ b/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/ConfigurationInterface.php @@ -0,0 +1,19 @@ +<?php +namespace Aws\S3\UseArnRegion; + +interface ConfigurationInterface +{ + /** + * Returns whether or not to use the ARN region if it differs from client + * + * @return bool + */ + public function isUseArnRegion(); + + /** + * Returns the configuration as an associative array + * + * @return array + */ + public function toArray(); +} diff --git a/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/ConfigurationProvider.php b/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/ConfigurationProvider.php new file mode 100644 index 0000000..b9ced4e --- /dev/null +++ b/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/ConfigurationProvider.php @@ -0,0 +1,175 @@ +<?php +namespace Aws\S3\UseArnRegion; + +use Aws\AbstractConfigurationProvider; +use Aws\CacheInterface; +use Aws\ConfigurationProviderInterface; +use Aws\S3\UseArnRegion\Exception\ConfigurationException; +use GuzzleHttp\Promise; + +/** + * A configuration provider is a function that returns a promise that is + * fulfilled with a {@see \Aws\S3\UseArnRegion\ConfigurationInterface} + * or rejected with an {@see \Aws\S3\UseArnRegion\Exception\ConfigurationException}. + * + * <code> + * use Aws\S3\UseArnRegion\ConfigurationProvider; + * $provider = ConfigurationProvider::defaultProvider(); + * // Returns a ConfigurationInterface or throws. + * $config = $provider()->wait(); + * </code> + * + * Configuration providers can be composed to create configuration using + * conditional logic that can create different configurations in different + * environments. You can compose multiple providers into a single provider using + * {@see Aws\S3\UseArnRegion\ConfigurationProvider::chain}. This function + * accepts providers as variadic arguments and returns a new function that will + * invoke each provider until a successful configuration is returned. + * + * <code> + * // First try an INI file at this location. + * $a = ConfigurationProvider::ini(null, '/path/to/file.ini'); + * // Then try an INI file at this location. + * $b = ConfigurationProvider::ini(null, '/path/to/other-file.ini'); + * // Then try loading from environment variables. + * $c = ConfigurationProvider::env(); + * // Combine the three providers together. + * $composed = ConfigurationProvider::chain($a, $b, $c); + * // Returns a promise that is fulfilled with a configuration or throws. + * $promise = $composed(); + * // Wait on the configuration to resolve. + * $config = $promise->wait(); + * </code> + */ +class ConfigurationProvider extends AbstractConfigurationProvider + implements ConfigurationProviderInterface +{ + const ENV_USE_ARN_REGION = 'AWS_S3_USE_ARN_REGION'; + const INI_USE_ARN_REGION = 's3_use_arn_region'; + const DEFAULT_USE_ARN_REGION = true; + + public static $cacheKey = 'aws_s3_use_arn_region_config'; + + protected static $interfaceClass = ConfigurationInterface::class; + protected static $exceptionClass = ConfigurationException::class; + + /** + * Create a default config provider that first checks for environment + * variables, then checks for a specified profile in the environment-defined + * config file location (env variable is 'AWS_CONFIG_FILE', file location + * defaults to ~/.aws/config), then checks for the "default" profile in the + * environment-defined config file location, and failing those uses a default + * fallback set of configuration options. + * + * This provider is automatically wrapped in a memoize function that caches + * previously provided config options. + * + * @param array $config + * + * @return callable + */ + public static function defaultProvider(array $config = []) + { + $configProviders = [self::env()]; + if ( + !isset($config['use_aws_shared_config_files']) + || $config['use_aws_shared_config_files'] != false + ) { + $configProviders[] = self::ini(); + } + $configProviders[] = self::fallback(); + + $memo = self::memoize( + call_user_func_array([ConfigurationProvider::class, 'chain'], $configProviders) + ); + + if (isset($config['use_arn_region']) + && $config['use_arn_region'] instanceof CacheInterface + ) { + return self::cache($memo, $config['use_arn_region'], self::$cacheKey); + } + + return $memo; + } + + /** + * Provider that creates config from environment variables. + * + * @return callable + */ + public static function env() + { + return function () { + // Use config from environment variables, if available + $useArnRegion = getenv(self::ENV_USE_ARN_REGION); + if (!empty($useArnRegion)) { + return Promise\Create::promiseFor( + new Configuration($useArnRegion) + ); + } + + return self::reject('Could not find environment variable config' + . ' in ' . self::ENV_USE_ARN_REGION); + }; + } + + /** + * Config provider that creates config using a config file whose location + * is specified by an environment variable 'AWS_CONFIG_FILE', defaulting to + * ~/.aws/config if not specified + * + * @param string|null $profile Profile to use. If not specified will use + * the "default" profile. + * @param string|null $filename If provided, uses a custom filename rather + * than looking in the default directory. + * + * @return callable + */ + public static function ini($profile = null, $filename = null) + { + $filename = $filename ?: (self::getDefaultConfigFilename()); + $profile = $profile ?: (getenv(self::ENV_PROFILE) ?: 'default'); + + return function () use ($profile, $filename) { + if (!@is_readable($filename)) { + return self::reject("Cannot read configuration from $filename"); + } + + // Use INI_SCANNER_NORMAL instead of INI_SCANNER_TYPED for PHP 5.5 compatibility + $data = \Aws\parse_ini_file($filename, true, INI_SCANNER_NORMAL); + if ($data === false) { + return self::reject("Invalid config file: $filename"); + } + if (!isset($data[$profile])) { + return self::reject("'$profile' not found in config file"); + } + if (!isset($data[$profile][self::INI_USE_ARN_REGION])) { + return self::reject("Required S3 Use Arn Region config values + not present in INI profile '{$profile}' ({$filename})"); + } + + // INI_SCANNER_NORMAL parses false-y values as an empty string + if ($data[$profile][self::INI_USE_ARN_REGION] === "") { + $data[$profile][self::INI_USE_ARN_REGION] = false; + } + + return Promise\Create::promiseFor( + new Configuration($data[$profile][self::INI_USE_ARN_REGION]) + ); + }; + } + + /** + * Fallback config options when other sources are not set. + * + * @return callable + */ + public static function fallback() + { + return function () { + return Promise\Create::promiseFor( + new Configuration(self::DEFAULT_USE_ARN_REGION) + ); + }; + } +} diff --git a/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/Exception/ConfigurationException.php b/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/Exception/ConfigurationException.php new file mode 100644 index 0000000..15d06a9 --- /dev/null +++ b/vendor/aws/aws-sdk-php/src/S3/UseArnRegion/Exception/ConfigurationException.php @@ -0,0 +1,14 @@ +<?php +namespace Aws\S3\UseArnRegion\Exception; + +use Aws\HasMonitoringEventsTrait; +use Aws\MonitoringEventsInterface; + +/** + * Represents an error interacting with configuration for S3's UseArnRegion + */ +class ConfigurationException extends \RuntimeException implements + MonitoringEventsInterface +{ + use HasMonitoringEventsTrait; +} |