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

# Criar uma aplicação simples usando o AWS SDK para PHP versão 3
<a name="hello"></a>

Diga olá ao Amazon S3 usando o AWS SDK para PHP. O exemplo a seguir mostra uma lista dos seus buckets do Amazon S3.

## Pré-requisitos
<a name="hello-prerequisites"></a>
+  [Download e instalação do SDK](getting-started_installation.md) 
+ Antes de usar o AWS SDK para PHP, você deve configurar a autenticação na AWS. Para obter informações sobre a configuração de autenticação, consulte [Autenticando com o AWS uso da AWS SDK para PHP versão 3](credentials.md).

## Incluir o SDK em seu código
<a name="including-the-sdk-in-your-code"></a>

Independentemente da técnica usada para instalar o SDK, é possível incluir o SDK em seu código com apenas uma única instrução `require`. Consulte a tabela a seguir para obter o código PHP mais adequado para sua técnica de instalação. Substitua todas as instâncias de `/path/to/` pelo caminho real em seu sistema.


****  

| Técnica de instalação | Instrução Require | 
| --- | --- | 
|  Uso do Composer  |   `require '/path/to/vendor/autoload.php';`   | 
|  Uso do phar  |   `require '/path/to/aws.phar';`   | 
|  Uso da ZIP  |   `require '/path/to/aws-autoloader.php';`   | 

Neste tópico, assumimos o método de instalação do Composer. Se estiver usando outro método de instalação, você poderá voltar a esta seção para localizar o código `require` correto a ser usado.

## Escrever o código
<a name="sdk-hello-world-code"></a>

Verifique se você é capaz de se autenticar.

Copie e cole o código a seguir em um novo arquivo de origem. Salve e nomeie o arquivo como `hello-s3.php`.

```
<?php

require 'vendor/autoload.php';

use Aws\S3\S3Client;

/**
 * List your Amazon S3 buckets.
 */

//Create a S3Client
// snippet-start:[s3.php.list_buckets.main]
$s3Client = new S3Client([
    'profile' => 'default',
    'region' => 'us-west-2',
    'version' => '2006-03-01'
]);

//Listing all S3 Bucket
$buckets = $s3Client->listBuckets();
foreach ($buckets['Buckets'] as $bucket) {
    echo $bucket['Name'] . "\n";
}
```

## Executar o programa
<a name="sdk-hello-world-running"></a>

Abra um prompt de comando para executar seu programa PHP. A sintaxe de comando típica para executar um programa PHP é: 

```
php [source filename] [arguments...]
```

Esse código de exemplo não usa argumentos. Para executar esse código, digite o seguinte no prompt de comando: 

```
$ php hello-s3.php
```

## Próximas etapas
<a name="sdk-hello-world-next-steps"></a>

Para testar muitas outras operações do Amazon S3, confira o [Repositório de exemplos de código da AWS](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/php/example_code/s3) no GitHub.