Configurando o Região da AWS para a AWS SDK para PHP versão 3 - AWS SDK para PHP
Cadeia de resolução regionalPrá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 sua configuração externa.

Cadeia de resolução regional

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, isso 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 ~/.aws/config (ou o local especificado pela variável de AWS_CONFIG_FILE ambiente)

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

    3. Se não AWS_PROFILE for especificado, o SDK usará o perfil “padrão”

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

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

[profile production]
region = eu-central-1

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

  4. Se o SDK não encontrar nenhum 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:

Defina explicitamente a região no código de produção

Para aplicativos de produção, recomendamos definir explicitamente a Região em seu código em vez de confiar nas variáveis de ambiente ou no. config Isso torna seu código mais previsível e menos dependente da configuração externa.

Use 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 alterar o código.

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