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

# Instalando a AWS SDK para PHP versão 3
<a name="getting-started_installation"></a>

Você pode instalar a 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 a AWS SDK para PHP versão 3, certifique-se de que seu ambiente esteja usando a versão 8.1 ou posterior do PHP. Saiba mais sobre os [requisitos e as recomendações de ambiente](getting-started_requirements.md).

**nota**  
A instalação do SDK por meio dos métodos .phar e .zip exige que a [extensão PHP Multibyte String](https://www.php.net/manual/en/book.mbstring.php) seja instalada e ativada separadamente.

## Instale AWS SDK para PHP como uma dependência via Composer
<a name="install-sdk-php-as-a-dependency-via-composer"></a>

 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](http://getcomposer.org).

### Instalar o Composer
<a name="install-composer"></a>

Se o Composer ainda não estiver no seu projeto, baixe-o e instale-o na [página de download do Composer](http://getcomposer.org/download).
+ Para **Windows**, siga as instruções do Windows Installer.
+ Para **Linux**, siga as instruções de instalação da linha de comando.

### Adicionar AWS SDK para PHP como uma dependência via Composer
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

Se o [Composer já estiver instalado globalmente](https://getcomposer.org/doc/00-intro.md#globally) em seu sistema, execute o seguinte no diretório base do seu projeto para instalar 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
<a name="add-autoloader-to-your-php-scripts"></a>

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, da seguinte maneira.

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

## Instalação usando o Phar empacotado
<a name="installing-by-using-the-packaged-phar"></a>

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

Você pode [fazer download do phar empacotado](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.phar) 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
<a name="installing-by-using-the-zip-file"></a>

 AWS SDK para PHP Isso inclui um arquivo ZIP contendo todas as classes e dependências necessárias 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](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.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';
?>
```