Configurando clientes de serviço para a AWS SDK para PHP versão 3 externamente - AWS SDK para PHP
Cadeia de provedores de configuração para configuração do clienteCriar um cliente de serviço configurado usando configurações externasAWS SDK para PHP Variáveis de ambiente da 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á.

Configurando clientes de serviço para a AWS SDK para 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 AWS config arquivo compartilhado separado. 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 uma discussão completa sobre o AWS compartilhamento config e os credentials arquivos, consulte o Guia de referência de ferramentas AWS SDKs e ferramentas.

A maioria das variáveis de ambiente e configurações de config arquivos compartilhados são padronizadas e compartilhadas entre AWS SDKs ferramentas para oferecer suporte à funcionalidade consistente em diferentes linguagens de programação e aplicativos.

Para ver todas as configurações que o SDK pode resolver a partir das variáveis de ambiente ou dos arquivos de configuração, consulte a referência de configurações no AWS SDKs Guia de referência de ferramentas.

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 detalhes sobre a configuração de variáveis de ambiente, consulte variáveis de ambiente no Guia de referência de ferramentas AWS SDKs e ferramentas.

    • Observe que você pode configurar variáveis de ambiente para um shell em diferentes níveis de escopo: em todo o sistema, em todo 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á-los explicitamente no código, em uma configuração de ambiente ou no arquivo de 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, a AWS SDK para PHP versão 3 também usa cadeias de fornecedores especializadas, incluindo a cadeia de fornecedores de credenciais e a cadeia de Região da AWS resolução. 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 configuraçõ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 Serviços da AWS, lidando com 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 Região da AWS de fornecedores padrão e a cadeia de fornecedores 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.

AWS SDK para PHP Variáveis de ambiente da versão 3

Além das configurações de cross-sdk suportadas pela maioria AWS SDKs, a AWS SDK para 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 AWS config arquivo (~/.aws/config) além do (s) credentials arquivo (~/.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_AVISO DE DEPRECIAÇÃO DO PHP

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