Configurando o Região da AWS para a 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á.

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

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

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