As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurando o Região da AWS para a AWS SDK para PHP versão 3
<a name="aws-php-sdk-region-resolution"></a>

Os clientes do SDK se conectam a um AWS service (Serviço da AWS) em um específico Região da AWS que você especifica ao criar o cliente. Essa configuração permite que seu aplicativo interaja com AWS recursos nessa área geográfica. Quando você cria um cliente de serviço sem definir explicitamente uma Região, o SDK usa a Região padrão da configuração externa. 

## Cadeia da resolução da região
<a name="region-resolution-chain"></a>

A AWS SDK para PHP versão 3 usa a seguinte ordem para determinar qual região um cliente de serviço usa:

1. Região fornecida no código: se você definir explicitamente a região nas opções do construtor do cliente, ela terá precedência sobre todas as outras fontes.

   ```
   $s3Client = new Aws\S3\S3Client([
       'region' => 'us-west-2'
   ]);
   ```

1. Variáveis de ambiente: se nenhuma região for fornecida no código, o SDK verificará essas variáveis de ambiente na ordem:
   + `AWS_REGION`
   + `AWS_DEFAULT_REGION`

   ```
   # Example of setting Region through environment variables.
   export AWS_REGION=us-east-1
   ```

1. AWS arquivos de configuração — Se nenhuma variável de ambiente de região estiver definida, o SDK verificará os arquivos de configuração: AWS 

   1. O SDK examina em `~/.aws/config` (ou o local especificado pela variável de ambiente `AWS_CONFIG_FILE`)

   1. O SDK examina a configuração da região no perfil especificado pela variável de ambiente `AWS_PROFILE`

   1. Se nenhum `AWS_PROFILE` for especificado, o SDK usará o perfil “padrão”

   Como exemplo, suponha que temos as seguintes definições no arquivo de configuração:

   ```
   # Example ~/.aws/config file.
   [default]
   region = eu-west-1
   
   [profile production]
   region = eu-central-1
   ```

   Se a variável de ambiente `AWS_PROFILE` for definida com um valor de “produção”, os clientes usarão a `eu-central-1 Region`. Se nenhuma variável de ambiente `AWS_PROFILE` existir, os clientes usarão a região `eu-west-1`.

1. Se o SDK não encontrar um valor de região em nenhuma das fontes acima, ele gerará uma exceção, pois um valor de região é uma configuração obrigatória para um cliente de serviço.

## Práticas recomendadas
<a name="region-resolution-best-practices"></a>

Considere as seguintes melhores práticas ao trabalhar com regiões na AWS SDK para PHP versão 3:

**Definir explicitamente a região no código de produção**  
Para aplicações de produção, é recomendável definir explicitamente a região em seu código em vez de depender das variáveis de ambiente ou da `config`. Isso torna seu código mais previsível e menos dependente da configuração externa.

**Usar variáveis de ambiente para desenvolvimento e teste**  
Para ambientes de desenvolvimento e teste, o uso de variáveis de ambiente permite mais flexibilidade sem alteração do código.

**Usar perfis para vários ambientes**  
Se seu aplicativo precisar funcionar com vários AWS ambientes, considere usar perfis diferentes em seu AWS `config` arquivo e alternar entre eles conforme necessário.