Instalar o AWS SDK para PHP versão 3 - AWS SDK para PHP
Instalar o AWS SDK para PHP como uma dependência por meio do ComposerInstalação usando o Phar empacotadoInstalação usando o arquivo ZIP

Instalar o AWS SDK para PHP versão 3

É possível instalar o AWS SDK para PHP versão 3:

  • Como uma dependência por meio do Composer

  • Como um phar pré-empacotado do SDK

  • Como um arquivo ZIP do SDK

Antes de instalar o AWS SDK para PHP versão 3, garanta que seu ambiente esteja usando o PHP versão 8.1 ou posterior. Saiba mais sobre os requisitos e as recomendações de ambiente.

nota

A instalação do SDK por meio dos métodos .phar e .zip exige que a extensão PHP Multibyte String seja instalada e ativada separadamente.

Instalar o AWS SDK para PHP como uma dependência por meio do Composer

O Composer é a maneira recomendada de instalar o AWS SDK para PHP. O Composer é uma ferramenta para PHP que gerencia e instala as dependências de seu projeto.

Para obter mais informações sobre como instalar o Composer, configurar o carregamento automático e seguir outras práticas recomendadas para definir dependências, consulte getcomposer.org.

Instalar o Composer

Se o Composer ainda não estiver no seu projeto, baixe-o e instale-o na página de download do Composer.

  • Para Windows, siga as instruções do Windows Installer.

  • Para Linux, siga as instruções de instalação da linha de comando.

Adicione o AWS SDK para PHP como uma dependência por meio do Composer

Se o Composer já estiver instalado globalmente no seu sistema, execute o seguinte no diretório de base do seu projeto para instalar o AWS SDK para PHP como uma dependência:

$ composer require aws/aws-sdk-php

Caso contrário, digite este comando do Composer para instalar a versão mais recente do AWS SDK para PHP como uma dependência.

$ php -d memory_limit=-1 composer.phar require aws/aws-sdk-php

Adicionar carregador automático aos scripts PHP

Instalar o Composer cria várias pastas e arquivos no ambiente. O arquivo primário que será usado é autoload.php, que se encontra na pasta vendor no ambiente.

Para utilizar o AWS SDK para PHP em seus scripts, inclua o carregador automático em seus scripts, como mostrado a seguir.

<?php
   require '/path/to/vendor/autoload.php';
?>

Instalação usando o Phar empacotado

Cada versão do AWS SDK para PHP inclui um phar pré-empacotado (arquivo PHP) que contém todas as classes e dependências de que você precisa para executar o SDK. Além disso, o phar registra automaticamente uma classe de carregador automático para o AWS SDK para PHP e todas as suas dependências.

Você pode fazer download do phar empacotado e incluí-lo em seus scripts.

<?php
   require '/path/to/aws.phar';
?>
nota

O uso do PHP com o patch Suhosin não é recomendado, mas é comum em distribuições do Ubuntu e do Debian. Nesse caso, pode ser necessário habilitar o uso de phars no suhosin.ini. Se você não fizer isso, a inclusão de um arquivo phar em seu código provocará uma falha silenciosa. Para modificar o suhosin.ini, adicione a linha a seguir.

suhosin.executor.include.whitelist = phar

Instalação usando o arquivo ZIP

O AWS SDK para PHP inclui um arquivo ZIP que contém todas as classes e dependências de que você precisa para executar o SDK. Além disso, o arquivo ZIP inclui uma classe de carregador automático para o AWS SDK para PHP e suas dependências.

Para instalar o SDK, faça download do arquivo .zip e extraia-o em seu projeto em um local de sua escolha. Em seguida, inclua o carregador automático em seus scripts, conforme mostrado a seguir.

<?php
   require '/path/to/aws-autoloader.php';
?>