Configurar a Região da AWS para o AWS SDK para PHP versão 3 - AWS SDK para PHP
Cadeia da resolução da regiãoPráticas recomendadas

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á.

Configurar a Região da AWS para o AWS SDK para PHP versão 3

Os clientes do SDK se conectam a um AWS service (Serviço da AWS) em uma Região da AWS específica que você determina ao criar o cliente. Essa configuração permite que a aplicação interaja com recursos da AWS 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

O 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'
]);

  2. 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

  3. Arquivos de configuração da AWS: se nenhuma variável de ambiente de Região for definida, o SDK verificará os arquivos de configuração da AWS:

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

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

    3. 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.

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

Práticas recomendadas

Considere as seguintes práticas recomendadas ao trabalhar com Regiões no 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 sua aplicação precisar funcionar com vários ambientes da AWS, considere usar perfis diferentes em seu arquivo config da AWS e alternar entre eles conforme necessário.