Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Creación de una aplicación simple con la versión 3 del AWS SDK para PHP
<a name="hello"></a>

Descubre Amazon S3 utilizando AWS SDK para PHP. El siguiente ejemplo se muestra una lista de sus buckets de Amazon S3.

## Requisitos previos
<a name="hello-prerequisites"></a>
+  [Descargar e instalar el SDK](getting-started_installation.md) 
+ Antes de utilizar el AWS SDK para PHP, debe configurar la autenticación con AWS. Para obtener información acerca de la configuración de la autenticación, consulte [Autenticación AWS con la AWS SDK para PHP versión 3](credentials.md)

## Incluya el SDK en su código
<a name="including-the-sdk-in-your-code"></a>

Independientemente de la técnica utilizada para instalar el SDK, puede incluir el SDK en su código con tan solo una única instrucción `require`. Consulte la siguiente tabla para saber qué código PHP se adapta mejor a su técnica de instalación. Sustituya las instancias de `/path/to/` por la ruta real de su sistema.


****  

| Técnica de instalación | Instrucción require | 
| --- | --- | 
|  Uso de Composer  |   `require '/path/to/vendor/autoload.php';`   | 
|  Uso de phar  |   `require '/path/to/aws.phar';`   | 
|  Uso de ZIP  |   `require '/path/to/aws-autoloader.php';`   | 

En este tema, utilizamos el método de instalación de Composer. Si utiliza un método de instalación diferente, puede consultar esta sección para encontrar el código `require` correcto que debe usar.

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

Asegúrese de que puede autenticarse.

Copie y pegue el siguiente código en un nuevo archivo de origen. Guarde y asigne un nombre al archivo `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";
}
```

## Ejecución del programa
<a name="sdk-hello-world-running"></a>

Abra un comando para ejecutar su programa PHP. La sintaxis de comando habitual para ejecutar un programa PHP es: 

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

Este ejemplo de código no utiliza argumentos. Para ejecutar este código, introduzca el siguiente comando del sistema: 

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

## Pasos a seguir a continuación
<a name="sdk-hello-world-next-steps"></a>

Para probar muchas otras operaciones de Amazon S3, consulte el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/php/example_code/s3) en GitHub.