Configurar clientes de serviço para o AWS SDK for PHP versão 3 externamente - AWS SDK for PHP
Cadeia de provedores de configuração para configuração do clienteCriar um cliente de serviço configurado usando definições externasVariáveis de ambiente do AWS SDK for PHP versão 3

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 clientes de serviço para o AWS SDK for PHP versão 3 externamente

Muitas configurações podem ser tratadas fora do código. A maioria das configurações pode ser definida como variáveis de ambiente ou em um arquivo config da AWS compartilhado distinto. O arquivo config da AWS compartilhado pode manter conjuntos separados de configurações, conhecidos como perfis, para fornecer configurações diferentes a ambientes ou testes distintos. Para obter uma explicação completa sobre os arquivos config e credentials da AWS compartilhados, consulte o Guia de referência de SDKs e ferramentas da AWS.

A maioria das configurações de variáveis de ambiente e do arquivo config compartilhado é padronizada e compartilhada entre os SDKs e ferramentas da AWS para oferecer suporte a funcionalidades consistentes em diferentes linguagens de programação e aplicações.

Consulte todas as configurações que podem ser tratadas pelo SDK com base nas variáveis de ambiente ou nos arquivos de configuração na Referência de configurações do Guia de referência de SDKs e ferramentas da AWS.

Cadeia de provedores de configuração para configuração do cliente

O SDK verifica vários locais (ou fontes) para encontrar valores de configuração.

  1. Qualquer configuração explícita definida no código ou no próprio cliente de serviço tem precedência sobre qualquer outra coisa.

  2. Variáveis de ambiente

    • Para obter mais detalhes sobre a configuração de variáveis de ambiente, consulte variáveis de ambiente no Guia de referência de SDKs e ferramentas da AWS.

    • Observe que você pode configurar variáveis de ambiente para um shell em diferentes níveis de escopo: em todo o sistema, para o usuário e para uma sessão de terminal específica.

  3. Arquivos config e credentials compartilhados

  4. Qualquer valor padrão fornecido pelo próprio código-fonte do SDK é usado por último.

    • Algumas propriedades, como região, não têm um padrão. Você deve especificá-las explicitamente no código, em uma configuração de ambiente ou no arquivo config compartilhado. Se o SDK não conseguir resolver a configuração exigida, as solicitações de API poderão falhar no runtime.

Além dessa cadeia de configuração geral, o AWS SDK for PHP versão 3 também usa cadeias de provedores especializados, incluindo a cadeia de provedores de credenciais e a cadeia de resolução da Região da AWS. Essas cadeias especializadas incluem provedores extras que consideram o ambiente no qual o SDK está sendo executado. Por exemplo, em um contêiner ou uma instância do EC2.

Criar um cliente de serviço configurado usando definições externas

Você precisa criar um cliente de serviço na aplicação para se comunicar com um AWS service (Serviço da AWS). Os clientes de serviço são sua conexão essencial com os Serviços da AWS, gerenciando todos os detalhes complexos da comunicação para que você não precise se preocupar com eles. Eles cuidam automaticamente de tarefas importantes, como segurança, tratamento de erros e novas tentativas, permitindo que você se concentre na criação da aplicação em vez de lidar com complicações técnicas.

Construir um cliente de serviço usando um construtor sem parâmetros

Se todas as configurações necessárias tiverem origem em fontes externas, você poderá criar um cliente de serviço usando um construtor vazio:

require 'vendor/autoload.php';

use Aws\S3\S3Client;

$s3 = new S3Client([]);

O trecho de código anterior cria uma instância do S3Client. Durante a criação, o SDK examina as configurações na cadeia de provedores de configuração. Depois que o SDK encontra um valor de configuração, ele o utiliza.

A cadeia de provedores da Região da AWS padrão e a cadeia de provedores de credenciais padrão também serão usadas no processo de criação. Em algum lugar da cadeia, o SDK deve resolver a Região da AWS a ser usada e encontrar configurações que o permitam recuperar credenciais para solicitações de assinatura. Se o SDK não encontrar esses valores, o cliente não será criado.

Variáveis de ambiente do AWS SDK for PHP versão 3

Além das configurações entre SDKs compatíveis com a maioria dos AWS SDKs, o AWS SDK for PHP versão 3 funciona com as seguintes variáveis de ambiente:

AWS_SDK_LOAD_NONDEFAULT_CONFIG

Quando definida, essa variável de ambiente instrui o SDK a carregar as credenciais do arquivo config (~/.aws/config) da AWS além do arquivo credentials (~/.aws/credentials).

AWS_SDK_UA_APP_ID

Define um identificador de aplicação personalizado que é incluído no cabeçalho User-Agent para solicitações feitas pelo SDK.

AWS_SUPPRESS_PHP_DEPRECATION_WARNING

Quando definida como verdadeira, suprime os avisos de depreciação do PHP que o SDK possa gerar.