

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.

# Introducción a la versión 3 del AWS SDK para PHP
<a name="getting-started_index"></a>

Este capítulo se ha pensado para prepararle para utilizar AWS SDK para PHP versión 3.

**Topics**
+ [Requisitos previos](getting-started_requirements.md)
+ [Instalación](getting-started_installation.md)
+ [Autenticarse con AWS](credentials.md)
+ [Creación de una aplicación simple](hello.md)
+ [AWS Cloud9 Úselo con el SDK](cloud9.md)

# Requisitos y recomendaciones para la AWS SDK para PHP versión 3
<a name="getting-started_requirements"></a>

Para obtener los mejores resultados AWS SDK para PHP, asegúrese de que su entorno cumpla con los siguientes requisitos y recomendaciones.

## Requisitos
<a name="requirements"></a>

Para usarlo AWS SDK para PHP, debe usar la versión 8.1 de PHP o posterior con la [extensión PHP SimpleXML habilitada](https://www.php.net/manual/en/book.simplexml.php). Si necesitas firmar Amazon como privado CloudFront URLs, también necesitas la extensión [OpenSSL](http://php.net/manual/en/book.openssl.php) para PHP.

## Recomendaciones
<a name="recommendations"></a>

Además de los requisitos mínimos, le recomendamos que también instale, desinstale y utilice lo siguiente.


****  

|  |  | 
| --- |--- |
|  Instale [cURL](http://php.net/manual/en/book.curl.php) 7.16.2 o posterior  |  Usa una versión reciente de cURL compilada con OpenSSL/NSS y zlib. Si cURL no está instalado en su sistema y no configura un http\$1handler personalizado para su cliente, el SDK utilizará el encapsulador de flujo de PHP.  | 
|  Uso de [OPCache](http://php.net/manual/en/book.opcache.php)   |  Utilice la OPcache extensión para mejorar el rendimiento de PHP almacenando el código de bytes del script precompilado en la memoria compartida. Esto elimina la necesidad de PHP de cargar y analizar scripts en cada solicitud. Esta extensión suele estar habilitada de forma predeterminada. Al ejecutar Amazon Linux, debe instalar el paquete yum php56-opcache o php55-opcache para usar la extensión. OPCache   | 
|  Desinstale [Xdebug](http://xdebug.org/) en entornos de producción   |  Xdebug le ayuda a identificar los cuellos de botella de rendimiento. Sin embargo, si el rendimiento es fundamental para la aplicación, no instale la extensión Xdebug en el entorno de producción. Cargar la extensión ralentiza el rendimiento del SDK de forma considerable.  | 
|  Utilice un cargador automático de classmap [Composer](http://getcomposer.org)  |  Los cargadores automáticos cargan clases cuando un script PHP lo requiere. Composer genera un cargador automático que puede cargar automáticamente scripts de PHP de su aplicación y todos los demás scripts de PHP que precisa su aplicación, incluido AWS SDK para PHP. Para los entornos de producción, se recomienda utilizar un cargador automático de classmap para mejorar el rendimiento del cargador automático. Puede generar un cargador automático de classmap transfiriendo la opción `-o` o `==optimize-autoloader` al comando de instalación de Composer.  | 

## Prueba de compatibilidad
<a name="compatibility-test"></a>

Ejecute el archivo [https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php](https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php) ubicado en la base de código del SDK para verificar que su sistema puede ejecutar el SDK. Además de cumplir los requisitos mínimos de sistema del SDK, la prueba de compatibilidad comprueba la configuración opcional y realiza recomendaciones que pueden ayudar a mejorar el rendimiento. La prueba de compatibilidad presenta los resultados en la línea de comandos o en un navegador web. Al revisar los resultados de la prueba en un navegador, las comprobaciones correctas aparecen en verde, las advertencias en morado y los errores en rojo. Si se muestra en la línea de comandos, el resultado de la comprobación aparece en una línea independiente.

Al informar sobre un problema con el SDK, compartir el resultado de la prueba de compatibilidad ayuda a identificar la causa subyacente.

# 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';
?>
```

# Autenticación AWS con la AWS SDK para PHP versión 3
<a name="credentials"></a>

Debes establecer cómo se autentica tu código AWS al desarrollar con Servicios de AWS. Puedes configurar el acceso programático a AWS los recursos de diferentes maneras en función del entorno y del AWS acceso del que dispongas. 

Para elegir el método de autenticación y configurarlo para el SDK, consulte [Autenticación y acceso](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) en la *Guía de referencia sobre herramientas AWS SDKs y herramientas*. 

## Configuración de la autenticación con IAM Identity Center para el desarrollo local
<a name="use-idc-for-auth"></a>

Recomendamos que los nuevos usuarios que desarrollen sus aplicaciones de forma local y que su empresa no les dé un método de autenticación lo configuren AWS IAM Identity Center. Este método incluye la instalación del AWS CLI para facilitar la configuración y para iniciar sesión con regularidad en el portal de AWS acceso. Si elige este método, su entorno debería contener los siguientes elementos después de completar el procedimiento de [autenticación del Centro de Identidad de IAM descrito](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) en la *Guía de referencia de herramientas AWS SDKs y herramientas:*
+ El AWS CLI, que se utiliza para iniciar una sesión en el portal de AWS acceso antes de ejecutar la aplicación.
+ Un [archivo `config` compartido de AWS](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) que tiene un perfil `[default]` con un conjunto de valores de configuración a los que puede hacer referencia el SDK. Para encontrar la ubicación de este archivo, consulte [Ubicación de los archivos compartidos](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) en la *Guía de referencia de AWS SDKs and Tools*.
+  El archivo `config` compartido contiene la configuración de [https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html). Esto establece el valor predeterminado Región de AWS que el SDK usa para las solicitudes. Esta región se utiliza para solicitudes de servicio del SDK que no están configuradas explícitamente con una propiedad `region`. 
+  El SDK utiliza la [configuración de proveedor de token de SSO](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#feature-sso-credentials-profile) del perfil para adquirir las credenciales antes de enviar las solicitudes a AWS. El `sso_role_name` valor, que es un rol de IAM conectado a un conjunto de permisos del Centro de Identidad de IAM, permite el acceso a los que Servicios de AWS se utilizan en la aplicación.

  El siguiente archivo `config` de ejemplo muestra la configuración de un perfil predeterminado con el proveedor de token de SSO. La configuración `sso_session` del perfil hace referencia a la [sección llamada `sso-session`](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#section-session). La `sso-session` sección contiene la configuración para iniciar una sesión en el portal de AWS acceso.

  ```
  [default]
  sso_session = my-sso
  sso_account_id = 111122223333
  sso_role_name = SampleRole
  region = us-east-1
  output = json
  
  [sso-session my-sso]
  sso_region = us-east-1
  sso_start_url = https://provided-domain.awsapps.com/start
  sso_registration_scopes = sso:account:access
  ```

 AWS SDK para PHP No es necesario añadir paquetes adicionales (por ejemplo, `SSO` y`SSOOIDC`) a la aplicación para utilizar la autenticación del IAM Identity Center.

## Inicie una sesión en el portal de AWS acceso
<a name="accessportal"></a>

Antes de ejecutar una aplicación para acceder Servicios de AWS, necesita una sesión activa en el portal de AWS acceso para que el SDK utilice la autenticación del IAM Identity Center a fin de resolver las credenciales. En función de la duración de las sesiones configuradas, el acceso terminará por caducar y SDK detectará un error de autenticación. Para iniciar sesión en el portal de AWS acceso, ejecute el siguiente comando en. AWS CLI

```
aws sso login
```

Si sigue la guía y utiliza una configuración de perfil predeterminada, no necesita llamar al comando con una opción `--profile`. Si la configuración del proveedor de token de SSO utiliza un perfil con nombre, el comando es `aws sso login --profile named-profile`.

Si lo desea, puede comprobar si ya tiene una sesión activa, ejecute el siguiente AWS CLI comando.

```
aws sts get-caller-identity
```

Si su sesión está activa, la respuesta a este comando debe indicar la cuenta y el conjunto de permisos del Centro de identidades de IAM configurados en el archivo `config` compartido.

**nota**  
Si ya tiene una sesión activa en el portal de AWS acceso y la ejecuta`aws sso login`, no tendrá que proporcionar credenciales.   
Es posible que el proceso de inicio de sesión le pida que permita el AWS CLI acceso a sus datos. Como AWS CLI se basa en el SDK para Python, los mensajes de permiso pueden contener variaciones del `botocore` nombre.

## Más información sobre la autenticación
<a name="credother"></a>
+ Para obtener más información sobre el uso del Centro de Identidad de IAM para la autenticación, consulte Cómo [entender la autenticación del Centro de Identidad de IAM](https://docs.aws.amazon.com/sdkref/latest/guide/understanding-sso.html) en la Guía de *AWS SDKs referencia y herramientas*
+ Para obtener más información sobre las prácticas recomendadas, consulte [Prácticas recomendadas de seguridad en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) en la *Guía del usuario de IAM*.
+ Para crear credenciales de corta duración, consulte AWS las credenciales de [seguridad temporales en la Guía](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) del usuario de *IAM.*
+ Para obtener más información sobre otros proveedores de credenciales que AWS SDK para PHP pueden utilizar, consulte los proveedores de [credenciales estandarizados en la Guía de](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) referencia de *herramientas AWS SDKs y herramientas*.

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

# AWS Cloud9 Úselo con la AWS SDK para PHP versión 3
<a name="cloud9"></a>

**nota**  
AWS Cloud9 ya no está disponible para nuevos clientes. Los clientes actuales de AWS Cloud9 pueden seguir utilizando el servicio con normalidad. [Más información](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/).

AWS Cloud9 es un entorno de desarrollo integrado (IDE) basado en la web que contiene un conjunto de herramientas que se utilizan para codificar, compilar, ejecutar, probar, depurar y lanzar software en la nube. Puedes usarlo AWS Cloud9 AWS SDK para PHP para escribir y ejecutar tu código PHP mediante un navegador. AWS Cloud9 incluye herramientas como un editor de código y un terminal. Como el AWS Cloud9 IDE está basado en la nube, puede trabajar en sus proyectos desde la oficina, el hogar o cualquier lugar mediante una máquina conectada a Internet. Para obtener información general al respecto AWS Cloud9, consulte la Guía del [AWS Cloud9 usuario](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html).

Siga estas instrucciones para configurar AWS Cloud9 con AWS SDK para PHP:
+  [Paso 1: Configura tu Cuenta de AWS uso AWS Cloud9](#cloud9-php-account) 
+  [Paso 2: Configura tu entorno AWS Cloud9 de desarrollo](#cloud9-php-environment) 
+  [Paso 3: Configure el AWS SDK para PHP](#cloud9-php-sdk) 
+  [Paso 4: Descargar el código de ejemplo](#cloud9-php-examples) 
+  [Paso 5: Ejecutar el código de ejemplo](#cloud9-php-run) 

## Paso 1: Configura tu Cuenta de AWS uso AWS Cloud9
<a name="cloud9-php-account"></a>

Para usarlo AWS Cloud9, inicia sesión en la AWS Cloud9 consola desde Consola de administración de AWS.

**nota**  
Si la utiliza AWS IAM Identity Center para autenticarse, es posible que necesite añadir el permiso necesario a la política asociada `iam:ListInstanceProfilesForRole` al usuario en la consola de IAM.

*Para configurar una entidad de IAM en su AWS cuenta para acceder a la AWS Cloud9 consola AWS Cloud9 e iniciar sesión en ella, consulte [Configuración de equipo AWS Cloud9 en la Guía del usuario](https://docs.aws.amazon.com/cloud9/latest/user-guide/setup.html).AWS Cloud9 *

## Paso 2: Configura tu entorno de AWS Cloud9 desarrollo
<a name="cloud9-php-environment"></a>

Después de iniciar sesión en la AWS Cloud9 consola, utilícela para crear un entorno de AWS Cloud9 desarrollo. Tras crear el entorno, AWS Cloud9 abre el IDE de ese entorno.

Para obtener más información, consulte cómo [crear un entorno en AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment.html) en la *guía del usuario de AWS Cloud9 *.

**nota**  
Al crear el entorno en la consola por primera vez, le recomendamos que elija la opción **Create a new instance for environment (EC2) [Crear una nueva instancia para el entorno (EC2)]**. Esta opción indica AWS Cloud9 que hay que crear un entorno, lanzar una instancia de Amazon EC2 y, a continuación, conectar la nueva instancia al nuevo entorno. Esta es la forma más rápida de empezar a AWS Cloud9 utilizarla.

Si el terminal todavía no está abierto en el IDE, ábralo. En la barra de menú del IDE, elija **Window, New Terminal (Ventana, Nuevo terminal)**. Puede utilizar la ventana de terminal para instalar herramientas y crear sus aplicaciones.

## Paso 3: Configura el AWS SDK para PHP
<a name="cloud9-php-sdk"></a>

Cuando AWS Cloud9 abra el IDE de su entorno de desarrollo, utilice la ventana de terminal para configurarlo AWS SDK para PHP en su entorno.

 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ñádalo 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';
?>
```

## Paso 4: Descargar el código de ejemplo
<a name="cloud9-php-examples"></a>

Utilice la ventana del terminal para descargar código de ejemplo para el entorno de AWS SDK para PHP desarrollo. AWS Cloud9 

Para descargar una copia de todos los ejemplos de código utilizados en la documentación oficial del AWS SDK en el directorio raíz de su entorno, ejecute el siguiente comando:

```
$ git clone https://github.com/awsdocs/aws-doc-sdk-examples.git
```

Los ejemplos de código para el AWS SDK para PHP se encuentran en el `ENVIRONMENT_NAME/aws-doc-sdk-examples/php` directorio, donde `ENVIRONMENT_NAME` aparece el nombre del entorno de desarrollo.

Para seguir con un ejemplo de Amazon S3, le recomendamos empezar con un ejemplo de código de `ENVIRONMENT_NAME/aws-doc-sdk-examples/php/example_code/s3/ListBuckets.php`. En este ejemplo se enumeran los buckets de Amazon S3. Utilice la ventana de terminal para acceder al directorio de `s3` y enumerar los archivos.

```
$ cd aws-doc-sdk-examples/php/example_code/s3
$ ls
```

Para abrir el archivo AWS Cloud9, puede hacer clic `ListBuckets.php` directamente en él en la ventana del terminal.

Si necesita más ayuda para entender los ejemplos de código, consulte la sección [Ejemplos de código de AWS SDK para PHP](examples_index.md).

## Paso 5: Ejecutar código de ejemplo
<a name="cloud9-php-run"></a>

Para ejecutar código en su entorno de AWS Cloud9 desarrollo, pulse el botón **Ejecutar** en la barra de menú superior. AWS Cloud9 detecta automáticamente la extensión del `.php` archivo y utiliza el ejecutor **PHP (servidor web integrado)** para ejecutar el código. Sin embargo, para este ejemplo vamos a usar la opción **PHP (`cli`)**. Para obtener más información sobre cómo ejecutar código en AWS Cloud9, consulte la sección sobre cómo [ejecutar código](https://docs.aws.amazon.com/cloud9/latest/user-guide/build-run-debug.html#build-run-debug-run) de la *guía del usuario de AWS Cloud9 *.

En la siguiente captura de pantalla, observe estas áreas básicas:
+ 1: Botón Run (Ejecutar). El botón **Run** (Ejecutar) se encuentra en la barra de menú superior. Se abrirá una nueva pestaña para ver los resultados. 
**nota**  
También puede crear nuevas configuraciones de ejecución manualmente. En la barra de menú, elija **Run** (Ejecutar), **Run Configurations** (Configuraciones de ejecución), **New Run Configuration** (Nueva configuración de ejecución).
+ 2: Comando. AWS Cloud9 rellena el cuadro de texto del **comando** con la ruta y el nombre del archivo que está ejecutando. Si el código espera que se le pasen parámetros de línea de comandos, puede añadirlos a la línea de comandos del mismo modo que lo haría al ejecutar el código a través de una ventana de terminal.
+ 3: Corredor. AWS Cloud9 detecta la extensión de tu archivo `.php` y selecciona el **PHP (servidor web integrado)** Runner para ejecutar tu código. Seleccione **PHP (`cli`)** para ejecutar este ejemplo en su lugar.

![\[Al seleccionar Ejecutar en la barra de menú superior del AWS Cloud9 IDE, se abre una nueva pestaña con el cuadro de comandos rellenado y el ejecutor de PHP ya seleccionado.\]](http://docs.aws.amazon.com/es_es/sdk-for-php/v3/developer-guide/images/cloud9_runconfig.png)


En la pestaña se muestra cualquier resultado generado a partir del código en ejecución.