

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Commencer à utiliser la AWS SDK pour PHP version 3
<a name="getting-started_index"></a>

Ce chapitre est dédié à vous aider à démarrer avec la AWS SDK pour PHP version 3.

**Topics**
+ [Conditions préalables](getting-started_requirements.md)
+ [Installation](getting-started_installation.md)
+ [Authentification avec AWS](credentials.md)
+ [Création d'une application simple](hello.md)
+ [Utilisation AWS Cloud9 avec le SDK](cloud9.md)

# Exigences et recommandations pour la AWS SDK pour PHP version 3
<a name="getting-started_requirements"></a>

Pour de meilleurs résultats AWS SDK pour PHP, assurez-vous que votre environnement répond aux exigences et recommandations suivantes.

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

Pour utiliser le AWS SDK pour PHP, vous devez utiliser PHP version 8.1 ou ultérieure avec l'[extension PHP SimpleXML activée](https://www.php.net/manual/en/book.simplexml.php). Si vous devez signer un compte Amazon privé CloudFront URLs, vous avez également besoin de l'[extension PHP OpenSSL](http://php.net/manual/en/book.openssl.php).

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

En plus de la configuration minimale requise, nous vous recommandons d'installer, de désinstaller et d'utiliser les éléments suivants.


****  

|  |  | 
| --- |--- |
|  Installez [cURL](http://php.net/manual/en/book.curl.php) 7.16.2 ou une version ultérieure  |  Utilisez une version récente de cURL compilée avec OpenSSL/NSS et zlib. Si cURL n'est pas installé sur votre système et si vous ne configurez pas de gestionnaire HTTP personnalisé pour votre client, le kit SDK utilisera l'encapsuleur de flux PHP.  | 
|  Utilisation des [OPCache](http://php.net/manual/en/book.opcache.php)   |  Utilisez l' OPcache extension pour améliorer les performances de PHP en stockant le bytecode du script précompilé dans la mémoire partagée. Ainsi, vous n'avez plus besoin de PHP pour charger et analyser des scripts sur chaque requête. Cette extension est généralement activée par défaut. Lorsque vous exécutez Amazon Linux, vous devez installer le package php56-opcache ou php55-opcache yum pour utiliser l'extension. OPCache   | 
|  Désinstallez [Xdebug dans les environnements](http://xdebug.org/) de production   |  Xdebug peut vous aider à identifier les goulots d'étranglement au niveau des performances. Toutefois, si les performances sont essentielles pour votre application, n'installez pas l'extension Xdebug dans votre environnement de production. Le chargement de cette extension ralentit considérablement les performances du kit SDK.  | 
|  Utilisez un chargeur automatique classmap [Composer](http://getcomposer.org)  |  Les chargeurs automatiques chargent les classes requises par un script PHP. Composer génère un chargeur automatique capable de charger automatiquement les scripts PHP de votre application ainsi que tous les autres scripts PHP qu'elle requiert, y compris le kit AWS SDK pour PHP. Nous vous recommandons d'utiliser un chargeur automatique classmap pour les environnements de production afin d'améliorer leurs performances. Vous pouvez générer un chargeur automatique classmap en spécifiant l'option `-o` ou `==optimize-autoloader` dans la commande d'installation de Composer.  | 

## Test de compatibilité
<a name="compatibility-test"></a>

Exécutez le [https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php](https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php)fichier situé dans la base de code du SDK pour vérifier que votre système peut exécuter le SDK. En plus de vérifier la configuration système minimale requise pour le kit SDK, le test de compatibilité contrôle certains paramètres facultatifs et propose des recommandations qui peuvent vous aider à améliorer les performances. Le test de compatibilité génère des résultats dans la ligne de commande ou dans un navigateur web. Si vous passez en revue les résultats du test dans un navigateur, les vérifications réussies s'affichent en vert, les avertissements s'affichent en violet et les échecs s'affichent en rouge. Lorsque vous exécutez le test à partir de la ligne de commande, chaque résultat d'un contrôle s'affiche sur une ligne distincte.

Lorsque vous signalez un problème concernant le kit SDK, pensez à partager le résultat du test de compatibilité afin de faciliter l'identification de la cause sous-jacente.

# Installation de la AWS SDK pour PHP version 3
<a name="getting-started_installation"></a>

Vous pouvez installer la AWS SDK pour PHP version 3 :
+ En tant que dépendance via Composer
+ En tant que phar prépackagé du kit SDK
+ En tant que fichier ZIP du kit SDK

Avant d'installer AWS SDK pour PHP la version 3, assurez-vous que votre environnement utilise PHP version 8.1 ou ultérieure. En savoir plus sur les [exigences et les recommandations en matière d'environnement](getting-started_requirements.md).

**Note**  
L'installation du SDK via les méthodes .phar et .zip nécessite que l'[extension PHP Multibyte String](https://www.php.net/manual/en/book.mbstring.php) soit installée et activée séparément.

## Installation AWS SDK pour PHP en tant que dépendance via Composer
<a name="install-sdk-php-as-a-dependency-via-composer"></a>

 Composer est la méthode recommandée pour installer le AWS SDK pour PHP. Composer est un outil PHP qui gère et installe les dépendances de votre projet.

Pour en savoir plus sur l’installation de Composer, la configuration du chargement automatique et le respect d’autres bonnes pratiques pour définir des dépendances, rendez-vous sur [getcomposer.org](http://getcomposer.org).

### Installation de Composer
<a name="install-composer"></a>

Si Composer n'est pas déjà dans votre projet, téléchargez et installez Composer sur la [page Télécharger Composer](http://getcomposer.org/download).
+ Pour **Windows**, suivez les instructions de Windows Installer.
+ Pour **Linux**, suivez les instructions d'installation en ligne de commande.

### Ajouter AWS SDK pour PHP en tant que dépendance via Composer
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

Si [Composer est déjà installé globalement](https://getcomposer.org/doc/00-intro.md#globally) sur votre système, exécutez ce qui suit dans le répertoire de base de votre projet pour l'installer AWS SDK pour PHP en tant que dépendance :

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

Sinon, tapez cette commande Composer pour installer la dernière version du AWS SDK pour PHP en tant que dépendance.

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

### Ajouter un chargeur automatique à vos scripts php
<a name="add-autoloader-to-your-php-scripts"></a>

L'installation de Composer crée plusieurs dossiers et fichiers dans votre environnement. Le fichier principal que vous utiliserez est `autoload.php`, qui se trouve dans le dossier `vendor` de votre environnement.

Pour utiliser le AWS SDK pour PHP dans vos scripts, incluez le chargeur automatique dans vos scripts, comme suit.

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

## Installation à l'aide du package phar
<a name="installing-by-using-the-packaged-phar"></a>

Chaque version AWS SDK pour PHP inclut un phar (archive PHP) préemballé qui contient toutes les classes et dépendances dont vous avez besoin pour exécuter le SDK. De plus, le phar enregistre automatiquement un chargeur automatique de classe pour toutes AWS SDK pour PHP ses dépendances.

Vous pouvez [télécharger le phar packagé](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.phar) et l’inclure dans vos scripts.

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

**Note**  
L'utilisation de PHP avec le correctif Suhosin n'est pas recommandée, mais elle est courante sur les distributions Ubuntu et Debian. Dans ce cas, il se peut que vous ayez besoin d'activer l'utilisation des phars dans le suhosin.ini. Si vous ne le faites pas, l'ajout d'un fichier phar à votre code provoquera un échec silencieux. Pour modifier suhosin.ini, ajoutez la ligne suivante.  

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

## Installation à l'aide du fichier ZIP
<a name="installing-by-using-the-zip-file"></a>

 AWS SDK pour PHP Il inclut un fichier ZIP contenant toutes les classes et dépendances dont vous avez besoin pour exécuter le SDK. De plus, le fichier ZIP inclut un chargeur automatique de classe pour le kit AWS SDK pour PHP et ses dépendances.

Pour installer le kit SDK, [téléchargez le fichier .zip](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.zip), puis extrayez-le dans votre projet à l’emplacement de votre choix. Incluez ensuite le chargeur automatique dans vos scripts, comme suit.

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

# Authentification à l' AWS aide de AWS SDK pour PHP la version 3
<a name="credentials"></a>

Vous devez définir la manière dont votre code s'authentifie AWS lorsque vous développez avec Services AWS. Vous pouvez configurer l'accès programmatique aux AWS ressources de différentes manières en fonction de l'environnement et de l' AWS accès dont vous disposez. 

Pour choisir votre méthode d'authentification et la configurer pour le SDK, consultez la section [Authentification et accès](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) dans le *guide de référence des outils AWS SDKs et*. 

## Configurer l'authentification avec IAM Identity Center pour le développement local
<a name="use-idc-for-auth"></a>

Nous recommandons aux nouveaux utilisateurs qui se développent localement et qui ne reçoivent aucune méthode d'authentification de la part de leur employeur de le configurer AWS IAM Identity Center. Cette méthode consiste à installer le AWS CLI pour faciliter la configuration et pour vous connecter régulièrement au portail AWS d'accès. Si vous choisissez cette méthode, votre environnement doit contenir les éléments suivants une fois que vous avez terminé la procédure d'[authentification IAM Identity Center décrite](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) dans le *guide de référence AWS SDKs and Tools :*
+ Le AWS CLI, que vous utilisez pour démarrer une session de portail d' AWS accès avant d'exécuter votre application.
+ [AWS`config`Fichier partagé](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) doté d'un `[default]` profil avec un ensemble de valeurs de configuration pouvant être référencées par le SDK. Pour connaître l'emplacement de ce fichier, reportez-vous à la section [Emplacement des fichiers partagés](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) dans le *Guide de référence des outils AWS SDKs et*.
+  Le `config` fichier partagé contient le [https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html)paramètre. Cela définit la valeur par défaut Région AWS que le SDK utilise pour les demandes. Cette région est utilisée pour les demandes de service du SDK qui ne sont pas explicitement configurées avec une `region` propriété. 
+  Le SDK utilise la [configuration du fournisseur de jetons SSO](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#feature-sso-credentials-profile) du profil pour obtenir des informations d'identification avant d'envoyer des demandes à. AWS La `sso_role_name` valeur, qui est un rôle IAM connecté à un ensemble d'autorisations IAM Identity Center, permet d'accéder à l'utilisateur Services AWS dans votre application.

  Le `config` fichier d'exemple suivant montre un profil par défaut configuré avec la configuration du fournisseur de jetons SSO. Le `sso_session` paramètre du profil fait référence à la [`sso-session`section](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#section-session) nommée. La `sso-session` section contient les paramètres permettant de lancer une session sur le portail AWS d'accès.

  ```
  [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
  ```

Il AWS SDK pour PHP n'est pas nécessaire d'ajouter des packages supplémentaires (tels que `SSO` et`SSOOIDC`) à votre application pour utiliser l'authentification IAM Identity Center.

## Démarrer une session sur le portail AWS d'accès
<a name="accessportal"></a>

Avant d'exécuter une application qui y accède Services AWS, vous avez besoin d'une session de portail d' AWS accès active pour que le SDK utilise l'authentification IAM Identity Center pour résoudre les informations d'identification. En fonction de la durée de session que vous avez configurée, votre accès finira par expirer et le SDK rencontrera une erreur d'authentification. Pour vous connecter au portail AWS d'accès, exécutez la commande suivante dans le AWS CLI.

```
aws sso login
```

Si vous avez suivi les instructions et que vous avez configuré un profil par défaut, il n'est pas nécessaire d'appeler la commande avec une `--profile` option. Si la configuration de votre fournisseur de jetons SSO utilise un profil nommé, la commande est `aws sso login --profile named-profile`.

Pour éventuellement vérifier si vous avez déjà une session active, exécutez la AWS CLI commande suivante.

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

Si votre session est active, la réponse à cette commande indique le compte IAM Identity Center et l'ensemble d'autorisations configurés dans le `config` fichier partagé.

**Note**  
Si vous disposez déjà d'une session active sur le portail AWS d'accès et que vous l'exécutez`aws sso login`, il ne vous sera pas demandé de fournir des informations d'identification.   
Le processus de connexion peut vous demander d'autoriser l' AWS CLI accès à vos données. Comme AWS CLI il repose sur le SDK pour Python, les messages d'autorisation peuvent contenir des variantes du `botocore` nom.

## En savoir plus sur l'authentification
<a name="credother"></a>
+ Pour plus de détails sur l'utilisation d'IAM Identity Center pour l'authentification, voir [Comprendre l'authentification IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/understanding-sso.html) dans le guide de référence *des outils AWS SDKs et*
+ Pour en savoir plus sur les bonnes pratiques, consultez [Bonnes pratiques de sécurité dans IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) dans le *Guide de l'utilisateur IAM*.
+ Pour créer des AWS informations d'identification à court terme, consultez la section [Informations d'identification de sécurité temporaires](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) dans le *guide de l'utilisateur IAM*.
+ Pour en savoir plus sur les autres fournisseurs d'informations d'identification qui AWS SDK pour PHP peuvent les utiliser, consultez la section [Fournisseurs d'informations d'identification standardisés](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) dans le guide de *référence AWS SDKs et Tools*.

# Création d'une application simple à l'aide de la AWS SDK pour PHP version 3
<a name="hello"></a>

Dites bonjour à Amazon S3 à l'aide du AWS SDK pour PHP. L'exemple suivant affiche la liste de vos compartiments Amazon S3.

## Prérequis
<a name="hello-prerequisites"></a>
+  [Téléchargez et installez le SDK](getting-started_installation.md) 
+ Avant d'utiliser le AWS SDK pour PHP, vous devez configurer l'authentification avec AWS. Pour plus d'informations sur la configuration de l'authentification, voir [Authentification à l' AWS aide de AWS SDK pour PHP la version 3](credentials.md)

## Inclure le SDK dans votre code
<a name="including-the-sdk-in-your-code"></a>

Quelle que soit la méthode que vous avez utilisée pour installer le kit SDK, vous pouvez inclure ce dernier dans votre code à l'aide d'une seule déclaration `require`. Consultez le tableau suivant pour savoir quel code PHP convient le mieux à votre installation technique. Remplacez toutes les occurrences de `/path/to/` par le chemin d'accès sur votre système.


****  

| Technique d'installation | Déclaration require | 
| --- | --- | 
|  Composer  |   `require '/path/to/vendor/autoload.php';`   | 
|  phar  |   `require '/path/to/aws.phar';`   | 
|  ZIP  |   `require '/path/to/aws-autoloader.php';`   | 

Dans cette rubrique, nous partons de la méthode d'installation de Composer. Si vous utilisez une autre méthode d'installation, vous pouvez revenir à cette section pour trouver le code `require` approprié à utiliser.

## Ecriture du code
<a name="sdk-hello-world-code"></a>

Assurez-vous de pouvoir vous authentifier.

Copiez et collez le code suivant dans un nouveau fichier source. Enregistrez le fichier et nommez-le`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";
}
```

## Exécution du programme
<a name="sdk-hello-world-running"></a>

Ouvrez une invite de commande pour exécuter votre programme PHP. La syntaxe de commande typique pour exécuter un programme PHP est la suivante : 

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

Cet exemple de code n'utilise aucun argument. Pour exécuter ce code, entrez ce qui suit dans l'invite de commande : 

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

## Étapes suivantes
<a name="sdk-hello-world-next-steps"></a>

Pour tester de nombreuses autres opérations Amazon S3, consultez le [référentiel d'exemples de AWS code](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/php/example_code/s3) sur GitHub.

# À utiliser AWS Cloud9 avec la AWS SDK pour PHP version 3
<a name="cloud9"></a>

**Note**  
AWS Cloud9 n'est plus disponible pour les nouveaux clients. Les clients existants de AWS Cloud9 peuvent continuer à utiliser le service normalement. [En savoir plus](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/).

AWS Cloud9 est un environnement de développement intégré (IDE) basé sur le Web qui contient un ensemble d'outils que vous pouvez utiliser pour coder, créer, exécuter, tester, déboguer et publier des logiciels dans le cloud. Vous pouvez utiliser AWS Cloud9 with AWS SDK pour PHP pour écrire et exécuter votre code PHP à l'aide d'un navigateur. AWS Cloud9 inclut des outils tels qu'un éditeur de code et un terminal. L' AWS Cloud9 IDE étant basé sur le cloud, vous pouvez travailler sur vos projets depuis votre bureau, votre domicile ou n'importe où en utilisant une machine connectée à Internet. Pour des informations générales à ce sujet AWS Cloud9, consultez le [guide de AWS Cloud9 l'utilisateur](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html).

Suivez ces instructions pour configurer AWS Cloud9 avec AWS SDK pour PHP :
+  [Étape 1 : Configurez votre appareil Compte AWS pour l'utiliser AWS Cloud9](#cloud9-php-account) 
+  [Étape 2 : Configuration de votre environnement AWS Cloud9 de développement](#cloud9-php-environment) 
+  [Étape 3 : Configurez le AWS SDK pour PHP](#cloud9-php-sdk) 
+  [Étape 4 : Téléchargez un exemple de code](#cloud9-php-examples) 
+  [Étape 5 : Exécuter un exemple de code](#cloud9-php-run) 

## Étape 1 : Configurez votre appareil Compte AWS pour l'utiliser AWS Cloud9
<a name="cloud9-php-account"></a>

Pour l'utiliser AWS Cloud9, connectez-vous à la AWS Cloud9 console depuis le AWS Management Console.

**Note**  
Si vous utilisez AWS IAM Identity Center pour vous authentifier, vous devrez peut-être ajouter l'autorisation requise de à la politique attachée `iam:ListInstanceProfilesForRole` à l'utilisateur dans la console IAM.

Pour configurer une entité IAM dans votre AWS compte afin d'accéder à la AWS Cloud9 console AWS Cloud9 et de s'y connecter, consultez la section [Configuration de l'équipe AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/setup.html) dans le *guide de l'AWS Cloud9 utilisateur*.

## Étape 2 : Configuration de votre environnement AWS Cloud9 de développement
<a name="cloud9-php-environment"></a>

Une fois connecté à la AWS Cloud9 console, utilisez-la pour créer un environnement de AWS Cloud9 développement. Après avoir créé l'environnement, AWS Cloud9 ouvre l'IDE correspondant à cet environnement.

Pour plus de détails, consultez [la section Création d'un environnement AWS Cloud9 dans](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment.html) le *guide de AWS Cloud9 l'utilisateur*.

**Note**  
Si vous créez votre environnement dans la console pour la première fois, nous vous recommandons de choisir l'option **Create a new instance for environment (EC2) (Créer une nouvelle instance pour l'environnement (EC2))**. Cette option indique AWS Cloud9 de créer un environnement, de lancer une instance Amazon EC2, puis de connecter la nouvelle instance au nouvel environnement. C'est le moyen le plus rapide de commencer à l'utiliser AWS Cloud9.

Si le terminal n'est pas déjà ouvert dans l'IDE, ouvrez-le. Choisissez **Window, New Terminal (Fenêtre, Nouveau terminal)** dans la barre de menus de l'IDE. Vous pouvez utiliser la fenêtre du terminal pour installer des outils et créer vos applications.

## Étape 3 : Configurez le AWS SDK pour PHP
<a name="cloud9-php-sdk"></a>

Après avoir AWS Cloud9 ouvert l'IDE pour votre environnement de développement, utilisez la fenêtre du terminal pour le configurer AWS SDK pour PHP dans votre environnement.

 Composer est la méthode recommandée pour installer le AWS SDK pour PHP. Composer est un outil PHP qui gère et installe les dépendances de votre projet.

Pour en savoir plus sur l’installation de Composer, la configuration du chargement automatique et le respect d’autres bonnes pratiques pour définir des dépendances, rendez-vous sur [getcomposer.org](http://getcomposer.org).

### Installation de Composer
<a name="install-composer"></a>

Si Composer n'est pas déjà dans votre projet, téléchargez et installez Composer sur la [page Télécharger Composer](http://getcomposer.org/download).
+ Pour **Windows**, suivez les instructions du programme d'installation de Windows.
+ Pour **Linux**, suivez les instructions d'installation en ligne de commande.

### Ajouter AWS SDK pour PHP en tant que dépendance via Composer
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

Si [Composer est déjà installé globalement](https://getcomposer.org/doc/00-intro.md#globally) sur votre système, exécutez ce qui suit dans le répertoire de base de votre projet pour l'installer AWS SDK pour PHP en tant que dépendance :

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

Sinon, tapez cette commande Composer pour installer la dernière version du AWS SDK pour PHP en tant que dépendance.

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

### Ajouter un chargeur automatique à vos scripts php
<a name="add-autoloader-to-your-php-scripts"></a>

L'installation de Composer crée plusieurs dossiers et fichiers dans votre environnement. Le fichier principal que vous utiliserez est `autoload.php`, qui se trouve dans le dossier `vendor` de votre environnement.

Pour utiliser le AWS SDK pour PHP dans vos scripts, incluez le chargeur automatique dans vos scripts, comme suit.

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

## Étape 4 : Téléchargez un exemple de code
<a name="cloud9-php-examples"></a>

Utilisez la fenêtre du terminal pour télécharger un exemple de code à utiliser AWS SDK pour PHP dans l'environnement de AWS Cloud9 développement.

Pour télécharger une copie de tous les exemples de code utilisés dans la documentation officielle du AWS SDK dans le répertoire racine de votre environnement, exécutez la commande suivante :

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

Les exemples de code pour le se AWS SDK pour PHP trouvent dans le `ENVIRONMENT_NAME/aws-doc-sdk-examples/php` répertoire, où se `ENVIRONMENT_NAME` trouve le nom de votre environnement de développement.

Pour suivre l'exemple d'Amazon S3, nous vous recommandons de commencer par un exemple de code`ENVIRONMENT_NAME/aws-doc-sdk-examples/php/example_code/s3/ListBuckets.php`. Cet exemple répertorie vos compartiments Amazon S3. Utilisez la fenêtre du terminal pour accéder au `s3` répertoire et répertorier les fichiers.

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

Pour ouvrir le fichier AWS Cloud9, vous pouvez cliquer sur le bouton `ListBuckets.php` directement dans la fenêtre du terminal.

Pour plus d'informations sur la compréhension des exemples de code, consultez la section [Exemples de AWS SDK pour PHP code](examples_index.md).

## Étape 5 : Exécuter un exemple de code
<a name="cloud9-php-run"></a>

Pour exécuter du code dans votre environnement de AWS Cloud9 développement, cliquez sur le bouton **Exécuter** dans la barre de menu supérieure. AWS Cloud9 détecte automatiquement l'extension du `.php` fichier et utilise le **moteur d'exécution PHP (serveur Web intégré)** pour exécuter le code. Cependant, pour cet exemple, nous voulons réellement l'option **PHP (`cli`)**. Pour plus d'informations sur l'exécution de code dans AWS Cloud9, consultez la section [Exécuter votre code](https://docs.aws.amazon.com/cloud9/latest/user-guide/build-run-debug.html#build-run-debug-run) dans le *guide de AWS Cloud9 l'utilisateur*.

Dans la capture d'écran suivante, notez ces domaines de base :
+ 1 : Courez. Le bouton **Exécuter** se trouve dans la barre de menu supérieure. Cela ouvre un nouvel onglet pour vos résultats. 
**Note**  
Vous pouvez également créer manuellement de nouvelles configurations d'exécution. Dans la barre de menus, choisissez **Exécuter**, **Configurations d'exécution**, **Nouvelle configuration d'exécution**.
+ 2 : Commande. AWS Cloud9 remplit la zone de texte **Commande** avec le chemin et le nom du fichier que vous exécutez. Si votre code s'attend à ce que des paramètres de ligne de commande soient transmis, ceux-ci peuvent être ajoutés à la ligne de commande de la même manière que vous le feriez lorsque vous exécutez le code via une fenêtre de terminal.
+ 3 : Coureur. AWS Cloud9 détecte l'extension de votre fichier `.php` et sélectionne le **PHP (serveur Web intégré)** Runner pour exécuter votre code. Sélectionnez **PHP (`cli`)** pour exécuter cet exemple à la place.

![\[Choisir Exécuter dans la barre de menu supérieure de l' AWS Cloud9 IDE ouvre un nouvel onglet avec la zone de commande remplie et le lanceur PHP déjà sélectionné.\]](http://docs.aws.amazon.com/fr_fr/sdk-for-php/v3/developer-guide/images/cloud9_runconfig.png)


Toute sortie générée à partir du code en cours d'exécution s'affiche dans l'onglet.