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 clienteCrie 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 manipuladas fora do seu código. A maioria das configurações pode ser definida como variáveis de ambiente ou em um AWS config arquivo compartilhado separado. O config arquivo AWS compartilhado pode manter conjuntos separados de configurações, chamados de perfis, para fornecer configurações diferentes para diferentes ambientes ou testes. 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 config arquivo compartilhado. Se o SDK não conseguir resolver a configuração necessária, as solicitações de API podem falhar em tempo de execução.

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 adicionam provedores adicionais que levam em conta o ambiente em que o SDK está sendo executado. Por exemplo, em um contêiner ou EC2 instância.

Crie um cliente de serviço configurado usando configurações externas

Você precisa criar um cliente de serviço em seu aplicativo para falar 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 de tarefas importantes, como segurança, tratamento de erros e novas tentativas automáticas, permitindo que você se concentre na criação de seu aplicativo em vez de lidar com complicações técnicas.

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

Se todas as configurações necessárias vierem de 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 S3Client instância. 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 usa o valor.

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 Região da AWS resolver as configurações de uso e localização que permitam recuperar credenciais para solicitações de assinatura. Se o SDK não conseguir encontrar esses valores, a criação do cliente falhará.

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 aplicativo personalizado que é incluído no cabeçalho User-Agent para solicitações feitas pelo SDK.

AWS_SUPPRESS_AVISO DE DEPRECIAÇÃO DO PHP

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