data = $definition; } public function getName() { return $this->data['partition']; } /** * @internal * @return mixed */ public function getDnsSuffix() { return $this->data['dnsSuffix']; } public function isRegionMatch($region, $service) { if (isset($this->data['regions'][$region]) || isset($this->data['services'][$service]['endpoints'][$region])) { return \true; } if (isset($this->data['regionRegex'])) { return (bool) \preg_match("@{$this->data['regionRegex']}@", $region); } return \false; } public function getAvailableEndpoints($service, $allowNonRegionalEndpoints = \false) { if ($this->isServicePartitionGlobal($service)) { return [$this->getPartitionEndpoint($service)]; } if (isset($this->data['services'][$service]['endpoints'])) { $serviceRegions = \array_keys($this->data['services'][$service]['endpoints']); return $allowNonRegionalEndpoints ? $serviceRegions : \array_intersect($serviceRegions, \array_keys($this->data['regions'])); } return []; } public function __invoke(array $args = []) { $service = isset($args['service']) ? $args['service'] : ''; $region = isset($args['region']) ? $args['region'] : ''; $scheme = isset($args['scheme']) ? $args['scheme'] : 'https'; $options = isset($args['options']) ? $args['options'] : []; $data = $this->getEndpointData($service, $region, $options); $variant = $this->getVariant($options, $data); if (isset($variant['hostname'])) { $template = $variant['hostname']; } else { $template = isset($data['hostname']) ? $data['hostname'] : ''; } $dnsSuffix = isset($variant['dnsSuffix']) ? $variant['dnsSuffix'] : $this->data['dnsSuffix']; return ['endpoint' => "{$scheme}://" . $this->formatEndpoint($template, $service, $region, $dnsSuffix), 'signatureVersion' => $this->getSignatureVersion($data), 'signingRegion' => isset($data['credentialScope']['region']) ? $data['credentialScope']['region'] : $region, 'signingName' => isset($data['credentialScope']['service']) ? $data['credentialScope']['service'] : $service]; } private function getEndpointData($service, $region, $options) { $defaultRegion = $this->resolveRegion($service, $region, $options); $data = isset($this->data['services'][$service]['endpoints'][$defaultRegion]) ? $this->data['services'][$service]['endpoints'][$defaultRegion] : []; $data += isset($this->data['services'][$service]['defaults']) ? $this->data['services'][$service]['defaults'] : []; $data += isset($this->data['defaults']) ? $this->data['defaults'] : []; return $data; } private function getSignatureVersion(array $data) { static $supportedBySdk = ['s3v4', 'v4', 'anonymous']; $possibilities = \array_intersect($supportedBySdk, isset($data['signatureVersions']) ? $data['signatureVersions'] : ['v4']); return \array_shift($possibilities); } private function resolveRegion($service, $region, $options) { if (isset($this->data['services'][$service]['endpoints'][$region]) && $this->isFipsEndpointUsed($region)) { return $region; } if ($this->isServicePartitionGlobal($service) || $this->isStsLegacyEndpointUsed($service, $region, $options) || $this->isS3LegacyEndpointUsed($service, $region, $options)) { return $this->getPartitionEndpoint($service); } return $region; } private function isServicePartitionGlobal($service) { return isset($this->data['services'][$service]['isRegionalized']) && \false === $this->data['services'][$service]['isRegionalized'] && isset($this->data['services'][$service]['partitionEndpoint']); } /** * STS legacy endpoints used for valid regions unless option is explicitly * set to 'regional' * * @param string $service * @param string $region * @param array $options * @return bool */ private function isStsLegacyEndpointUsed($service, $region, $options) { return $service === 'sts' && \in_array($region, $this->stsLegacyGlobalRegions) && (empty($options['sts_regional_endpoints']) || ConfigurationProvider::unwrap($options['sts_regional_endpoints'])->getEndpointsType() !== 'regional'); } /** * S3 legacy us-east-1 endpoint used for valid regions unless option is explicitly * set to 'regional' * * @param string $service * @param string $region * @param array $options * @return bool */ private function isS3LegacyEndpointUsed($service, $region, $options) { return $service === 's3' && $region === 'us-east-1' && (empty($options['s3_us_east_1_regional_endpoint']) || S3ConfigurationProvider::unwrap($options['s3_us_east_1_regional_endpoint'])->getEndpointsType() !== 'regional'); } private function getPartitionEndpoint($service) { return $this->data['services'][$service]['partitionEndpoint']; } private function formatEndpoint($template, $service, $region, $dnsSuffix) { return \strtr($template, ['{service}' => $service, '{region}' => $region, '{dnsSuffix}' => $dnsSuffix]); } /** * @param $region * @return bool */ private function isFipsEndpointUsed($region) { return \strpos($region, "fips") !== \false; } /** * @param array $options * @param array $data * @return array */ private function getVariant(array $options, array $data) { $variantTags = []; if (isset($options['use_fips_endpoint'])) { $useFips = $options['use_fips_endpoint']; if (\is_bool($useFips)) { $useFips && ($variantTags[] = 'fips'); } elseif ($useFips->isUseFipsEndpoint()) { $variantTags[] = 'fips'; } } if (isset($options['use_dual_stack_endpoint'])) { $useDualStack = $options['use_dual_stack_endpoint']; if (\is_bool($useDualStack)) { $useDualStack && ($variantTags[] = 'dualstack'); } elseif ($useDualStack->isUseDualStackEndpoint()) { $variantTags[] = 'dualstack'; } } if (!empty($variantTags)) { if (isset($data['variants'])) { foreach ($data['variants'] as $variant) { if (\array_count_values($variant['tags']) == \array_count_values($variantTags)) { return $variant; } } } if (isset($this->data['defaults']['variants'])) { foreach ($this->data['defaults']['variants'] as $variant) { if (\array_count_values($variant['tags']) == \array_count_values($variantTags)) { return $variant; } } } } } }