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.

# Instalación de la AWS SDK para PHP versión 3
<a name="getting-started_installation"></a>

Puede instalar la AWS SDK para PHP versión 3:
+ Como una dependencia mediante Composer
+ Como phar empaquetado previamente del SDK
+ Como un archivo ZIP del SDK

Antes de instalar la AWS SDK para PHP versión 3, asegúrese de que su entorno utilice la versión 8.1 o posterior de PHP. Obtener más información sobre los [requisitos y las recomendaciones del entorno](getting-started_requirements.md).

**nota**  
La instalación del SDK a través de los métodos .phar y .zip requiere que la extensión [Multibyte String PHP](https://www.php.net/manual/en/book.mbstring.php) sea instalada y habilitada por separado.

## Instálelo AWS SDK para PHP como una dependencia mediante Composer
<a name="install-sdk-php-as-a-dependency-via-composer"></a>

 Composer es la forma recomendada de instalar AWS SDK para PHP. Composer es una herramienta para PHP que administra e instala las dependencias del proyecto.

Para obtener más información acerca de cómo instalar Composer, configure la carga automática y siga otras prácticas recomendadas para definir dependencias. Para ello, consulte [getcomposer.org](http://getcomposer.org).

### Instalación de Composer
<a name="install-composer"></a>

Si Composer aún no está en su proyecto, descárguelo e instálelo en la [página de descarga de Composer](http://getcomposer.org/download).
+ Para **Windows**, siga las instrucciones del instalador de Windows.
+ Para **Linux**, siga las instrucciones de instalación de la línea de comandos.

### AWS SDK para PHP Añádala como dependencia a través de Composer
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

Si [Composer ya está instalado globalmente](https://getcomposer.org/doc/00-intro.md#globally) en su sistema, ejecute lo siguiente en el directorio base de su proyecto para instalarlo AWS SDK para PHP como una dependencia:

```
$ composer require aws/aws-sdk-php
```

De lo contrario, escriba este comando de Composer para instalar la última versión de AWS SDK para PHP como una dependencia.

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

### Agregar un cargador automático a sus scripts de PHP
<a name="add-autoloader-to-your-php-scripts"></a>

Al instalar Composer, se crean varias carpetas y archivos en su entorno. El archivo principal que se va a utilizar es `autoload.php`, que está en la carpeta `vendor` de su entorno.

Para utilizarla AWS SDK para PHP en sus scripts, incluya el cargador automático en sus scripts de la siguiente manera.

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

## Instalación con el phar empaquetado
<a name="installing-by-using-the-packaged-phar"></a>

Cada versión AWS SDK para PHP incluye un phar (archivo PHP) preempaquetado que contiene todas las clases y dependencias necesarias para ejecutar el SDK. Además, el phar registra automáticamente un cargador automático de clases para la clase y todas sus dependencias. AWS SDK para PHP 

Puede [descargar el phar empaquetado](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.phar) e incluirlo en sus scripts.

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

**nota**  
No se recomienda utilizar archivos PHP con el parche Suhosin, aunque es común en distribuciones de Ubuntu y de Debian. En este caso, es posible que tenga que habilitar el uso de archivos phar en el archivo suhosin.ini. Si no lo hace e incluye un archivo phar en el código, se generará un error silencioso. Para modificar suhosin.ini, añada la siguiente línea.  

```
suhosin.executor.include.whitelist = phar
```

## Instalación con el archivo ZIP
<a name="installing-by-using-the-zip-file"></a>

 AWS SDK para PHP Incluye un archivo ZIP que contiene todas las clases y dependencias que necesitas para ejecutar el SDK. Además, el archivo ZIP incluye un cargador automático de clases para AWS SDK para PHP y sus dependencias.

Para instalar el SDK, [descargue el archivo .zip](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.zip) y, a continuación, extráigalo en su proyecto en la ubicación que elija. A continuación, incluya el cargador automático en sus scripts, tal y como se indica a continuación.

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