

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Guida introduttiva alla AWS SDK per PHP versione 3
<a name="getting-started_index"></a>

Questo capitolo è dedicato a farti iniziare a usare la AWS SDK per PHP versione 3.

**Topics**
+ [Prerequisiti](getting-started_requirements.md)
+ [Installazione](getting-started_installation.md)
+ [Autenticazione con AWS](credentials.md)
+ [Creazione di un'applicazione semplice](hello.md)
+ [Utilizzare AWS Cloud9 con l'SDK](cloud9.md)

# Requisiti e raccomandazioni per la AWS SDK per PHP versione 3
<a name="getting-started_requirements"></a>

Per ottenere risultati ottimali AWS SDK per PHP, assicuratevi che il vostro ambiente supporti i seguenti requisiti e consigli.

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

Per utilizzare il AWS SDK per PHP, è necessario utilizzare la versione PHP 8.1 o successiva con l'estensione [PHP SimpleXML abilitata](https://www.php.net/manual/en/book.simplexml.php). Se devi firmare un account Amazon privato CloudFront URLs, ti serve anche l'estensione [PHP OpenSSL](http://php.net/manual/en/book.openssl.php).

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

Oltre ai requisiti minimi, si consiglia inoltre di installare, disinstallare e utilizzare quanto segue.


****  

|  |  | 
| --- |--- |
|  Installare [cURL](http://php.net/manual/en/book.curl.php) 7.16.2 o la versione successiva  |  Usa una versione recente di cURL compilata con OpenSSL/NSS e zlib. Se cURL non è installato sul sistema e non si intende configurare un gestore http personalizzato per il client, l'SDK utilizza il wrapper di flusso PHP.  | 
|  Utilizzare [OPCache](http://php.net/manual/en/book.opcache.php)   |  Usa l' OPcache estensione per migliorare le prestazioni di PHP memorizzando il bytecode dello script precompilato nella memoria condivisa. Ciò evita che PHP debba caricare e analizzare gli script in ogni richiesta. Questa estensione è solitamente abilitata per impostazione predefinita. Quando esegui Amazon Linux, devi installare il pacchetto yum php56-opcache o php55-opcache per utilizzare l'estensione. OPCache   | 
|  [Disinstalla](http://xdebug.org/) Xdebug negli ambienti di produzione   |  Xdebug può aiutare a identificare i colli di bottiglia delle prestazioni. Tuttavia, se le prestazioni sono fondamentali per la propria applicazione, non installare l'estensione Xdebug nell'ambiente di produzione. Caricare l'estensione rallenta notevolmente le prestazioni dell'SDK.  | 
|  Usare un autoloader classmap [Composer](http://getcomposer.org)  |  Gli autoloader caricano le classi come richiesto da uno script PHP. Composer genera un autoloader che possa caricare gli script PHP dell'applicazione e tutti gli altri script PHP necessari per l'applicazione, tra cui l' AWS SDK per PHP. Per gli ambienti di produzione, è consigliabile utilizzare un autoloader classmap per migliorare le prestazioni. È possibile generare un autoloader classmap trasferendo l'opzione `-o` o `==optimize-autoloader` al comando di installazione del Composer.  | 

## Test di compatibilità
<a name="compatibility-test"></a>

Esegui il [https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php](https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php)file che si trova nella base di codice SDK per verificare che il tuo sistema sia in grado di eseguire l'SDK. Oltre a soddisfare i requisiti minimi di sistema dell'SDK, il test di compatibilità controlla le impostazioni facoltative e fornisce suggerimenti che possono aiutare a migliorare le prestazioni. Il test di compatibilità fornisce risultati per la riga di comando o per un browser web. Durante la revisione dei risultati del test in un browser, i controlli con esito positivo sono visualizzati in verde, le avvertenze in viola e gli errori in rosso. Quando si effettua l'esecuzione dalla riga di comando, il risultato di un controllo viene visualizzato su una riga separata.

Quando si segnala un problema con l'SDK, condividere l'output del test di compatibilità consente di identificare la causa sottostante.

# Installazione della AWS SDK per PHP versione 3
<a name="getting-started_installation"></a>

È possibile installare la AWS SDK per PHP versione 3:
+ Come dipendenza tramite Composer
+ Come un file phar contenuto nell'SDK
+ Come un file ZIP del kit SDK

Prima di installare la AWS SDK per PHP versione 3, assicurati che il tuo ambiente utilizzi la versione PHP 8.1 o successiva. Scopri di più sui [requisiti e sui consigli relativi all'ambiente](getting-started_requirements.md).

**Nota**  
L'installazione dell'SDK tramite i metodi .phar e.zip richiede che l'[estensione PHP Multibyte String sia installata e abilitata](https://www.php.net/manual/en/book.mbstring.php) separatamente.

## Installa come dipendenza tramite Composer AWS SDK per PHP
<a name="install-sdk-php-as-a-dependency-via-composer"></a>

 Composer è il metodo consigliato per installare. AWS SDK per PHP Composer è uno strumento per PHP in grado di gestire e installare le dipendenze del progetto.

Per ulteriori informazioni su come installare Composer, configurare il caricamento automatico e seguire le altre best practice per la definizione delle dipendenze, consulta [getcomposer.org](http://getcomposer.org).

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

Se Composer non è già presente nel progetto, scarica e installa Composer dalla pagina [Scarica](http://getcomposer.org/download) Composer.
+ Per **Windows**, seguite le istruzioni di Windows Installer.
+ Per **Linux**, segui le istruzioni di installazione della riga di comando.

### Aggiungi AWS SDK per PHP come dipendenza tramite Composer
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

Se [Composer è già installato globalmente](https://getcomposer.org/doc/00-intro.md#globally) sul sistema, esegui quanto segue nella directory di base del progetto per installarlo AWS SDK per PHP come dipendenza:

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

Altrimenti, digitate questo comando Composer per installare la versione più recente di AWS SDK per PHP come dipendenza.

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

### Aggiungi l'autoloader ai tuoi script php
<a name="add-autoloader-to-your-php-scripts"></a>

L'installazione di Composer crea diverse cartelle e file nell'ambiente. Il file principale che utilizzerai è `autoload.php`, che si trova nella cartella `vendor` dell'ambiente.

Per utilizzarli AWS SDK per PHP nei tuoi script, includi il caricatore automatico negli script, come segue.

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

## Installazione utilizzando il pacchetto phar
<a name="installing-by-using-the-packaged-phar"></a>

Ogni versione di AWS SDK per PHP include un phar (archivio PHP) preconfezionato che contiene tutte le classi e le dipendenze necessarie per eseguire l'SDK. Inoltre, il phar registra automaticamente un caricatore automatico di classi per tutte le sue dipendenze. AWS SDK per PHP 

Puoi [scaricare il file phar contenuto nel pacchetto](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.phar) e includerlo negli script.

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

**Nota**  
L'utilizzo di PHP con la patch Suhosin non è consigliato, ma è comune nelle distribuzioni Ubuntu e Debian. In questo caso, potresti dover abilitare l'uso degli archivi phar nel file suhosin.ini. Se non effettui questa operazione, l'inclusione di un file phar nel codice causerà un errore che non verrà segnalato. Per modificare il file suhosin.ini, aggiungi la riga seguente.  

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

## Installazione utilizzando il file ZIP
<a name="installing-by-using-the-zip-file"></a>

 AWS SDK per PHP Include un file ZIP contenente tutte le classi e le dipendenze necessarie per eseguire l'SDK. Inoltre, il file ZIP include un autoloader della classe per l' AWS SDK per PHP e tutte le relative dipendenze.

Per installare l'SDK, [scarica il file .zip](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.zip) ed estrailo nel progetto in un percorso di tua scelta. Quindi, includi l'autoloader negli script, come descritto di seguito.

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

# Autenticazione con l' AWS utilizzo AWS SDK per PHP della versione 3
<a name="credentials"></a>

È necessario stabilire in che modo il codice si autentica AWS durante lo sviluppo con. Servizi AWSÈ possibile configurare l'accesso programmatico alle AWS risorse in diversi modi a seconda dell'ambiente e dell' AWS accesso a disposizione. 

Per scegliere il metodo di autenticazione e configurarlo per l'SDK, consulta [Autenticazione e accesso](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) nella Guida di *riferimento agli strumenti AWS SDKs e agli strumenti*. 

## Configura l'autenticazione con IAM Identity Center per lo sviluppo locale
<a name="use-idc-for-auth"></a>

Consigliamo ai nuovi utenti che si stanno sviluppando localmente e che non dispongono di un metodo di autenticazione da parte del datore di lavoro di configurarlo AWS IAM Identity Center. Questo metodo include l'installazione di AWS CLI per facilitare la configurazione e per accedere regolarmente al portale di AWS accesso. Se scegli questo metodo, l'ambiente dovrebbe contenere i seguenti elementi dopo aver completato la procedura per l'[autenticazione di IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) nella *AWS SDKs and Tools Reference Guide*:
+ Il AWS CLI, che viene utilizzato per avviare una sessione del portale di AWS accesso prima di eseguire l'applicazione.
+ Un [AWS`config`file condiviso](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) con un `[default]` profilo con un set di valori di configurazione a cui può fare riferimento l'SDK. Per trovare la posizione di questo file, consulta [Posizione dei file condivisi nella Guida](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) di *riferimento agli strumenti AWS SDKs e strumenti*.
+  Il `config` file condiviso contiene l'[https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html)impostazione. Questo imposta l'impostazione predefinita Regione AWS utilizzata dall'SDK per le richieste. Questa regione viene utilizzata per le richieste di servizio SDK che non sono configurate esplicitamente con una proprietà. `region` 
+  L'SDK utilizza la [configurazione del provider di token SSO](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#feature-sso-credentials-profile) del profilo per acquisire le credenziali prima di inviare richieste a. AWS Il `sso_role_name` valore, che è un ruolo IAM connesso a un set di autorizzazioni IAM Identity Center, consente l'accesso ai dati Servizi AWS utilizzati nell'applicazione.

  Il seguente `config` file di esempio mostra un profilo predefinito impostato con la configurazione del provider di token SSO. L'`sso_session`impostazione del profilo si riferisce alla [`sso-session`sezione](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#section-session) denominata. La `sso-session` sezione contiene le impostazioni per avviare una sessione del portale di AWS accesso.

  ```
  [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 per PHP Non è necessario aggiungere pacchetti aggiuntivi (come `SSO` e`SSOOIDC`) all'applicazione per utilizzare l'autenticazione IAM Identity Center.

## Avvia una sessione del portale di AWS accesso
<a name="accessportal"></a>

Prima di eseguire un'applicazione che consente l'accesso Servizi AWS, è necessaria una sessione attiva del portale di AWS accesso affinché l'SDK utilizzi l'autenticazione IAM Identity Center per risolvere le credenziali. A seconda della durata della sessione configurata, l'accesso alla fine scadrà e l'SDK riscontrerà un errore di autenticazione. Per accedere al portale di AWS accesso, esegui il seguente comando in. AWS CLI

```
aws sso login
```

Se hai seguito le istruzioni e disponi di una configurazione predefinita del profilo, non è necessario richiamare il comando con un'`--profile`opzione. Se la configurazione del provider di token SSO utilizza un profilo denominato, il comando è `aws sso login --profile named-profile`.

Per verificare facoltativamente se hai già una sessione attiva, esegui il AWS CLI comando seguente.

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

Se la sessione è attiva, la risposta a questo comando riporta l'account IAM Identity Center e il set di autorizzazioni configurati nel `config` file condiviso.

**Nota**  
Se hai già una sessione attiva del portale di AWS accesso ed esegui`aws sso login`, non ti verrà richiesto di fornire credenziali.   
La procedura di accesso potrebbe richiedere all'utente di consentire l' AWS CLI accesso ai dati. Poiché AWS CLI è basato sull'SDK per Python, i messaggi di autorizzazione potrebbero contenere variazioni del `botocore` nome.

## Scopri di più sull'autenticazione
<a name="credother"></a>
+ Per maggiori dettagli sull'utilizzo di IAM Identity Center per l'autenticazione, consulta [Understand IAM Identity Center Authentication](https://docs.aws.amazon.com/sdkref/latest/guide/understanding-sso.html) nella *AWS SDKs and Tools Reference Guide*
+ Per ulteriori informazioni sulle best practice, consulta [Best practice per la sicurezza in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) nella *Guida per l'utente di IAM*.
+ Per creare AWS credenziali a breve termine, consulta [Temporary Security Credentials](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) nella *IAM User Guide*.
+ *Per ulteriori informazioni su altri fornitori di credenziali che AWS SDK per PHP possono utilizzare, consulta Fornitori di [credenziali standardizzati nella Guida di](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) riferimento agli strumenti e agli AWS SDKs strumenti.*

# Creazione di una semplice applicazione utilizzando la AWS SDK per PHP versione 3
<a name="hello"></a>

Dai il benvenuto ad Amazon S3 utilizzando il. AWS SDK per PHP L'esempio seguente mostra un elenco dei tuoi bucket Amazon S3.

## Prerequisiti
<a name="hello-prerequisites"></a>
+  [Scarica e installa l'SDK](getting-started_installation.md) 
+ Prima di utilizzare AWS SDK per PHP, è necessario configurare l'autenticazione con AWS. Per informazioni sulla configurazione dell'autenticazione, vedere [Autenticazione con l' AWS utilizzo AWS SDK per PHP della versione 3](credentials.md)

## Inclusione dell'SDK nel codice
<a name="including-the-sdk-in-your-code"></a>

Qualsiasi tecnica abbia utilizzato per installare l'SDK, è possibile includere l'SDK nel tuo codice con una sola istruzione `require`. Consulta la tabella riportata di seguito per individuare il codice PHP che meglio si adatta alle esigenze della tecnica di installazione. Sostituisci tutte le istanze di `/path/to/` con il percorso effettivo sul sistema.


****  

| Tecnica di installazione | Richiedere istruzione | 
| --- | --- | 
|  Utilizzo di Composer  |   `require '/path/to/vendor/autoload.php';`   | 
|  Utilizzo del file phar  |   `require '/path/to/aws.phar';`   | 
|  Utilizzo di ZIP  |   `require '/path/to/aws-autoloader.php';`   | 

In questo argomento, si presuppone il metodo di installazione di Composer. Se usi un metodo di installazione diverso, è possibile fare riferimento a questa sezione per trovare il codice `require` corretto da utilizzare.

## Scrivi il codice
<a name="sdk-hello-world-code"></a>

Assicurati di poter autenticarti.

Copia e incolla il codice seguente in un nuovo file sorgente. Salvate e assegnate un nome al file`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";
}
```

## Esecuzione del programma
<a name="sdk-hello-world-running"></a>

Apri un prompt dei comandi per eseguire il tuo programma PHP. La sintassi di comando tipica per eseguire un programma PHP è: 

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

Questo codice di esempio non utilizza argomenti. Per eseguire questo codice, inserisci quanto segue nel prompt dei comandi: 

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

## Passaggi successivi
<a name="sdk-hello-world-next-steps"></a>

Per testare molte altre operazioni di Amazon S3, consulta il [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/php/example_code/s3) su. GitHub

# Uso AWS Cloud9 con la AWS SDK per PHP versione 3
<a name="cloud9"></a>

**Nota**  
AWS Cloud9 non è più disponibile per i nuovi clienti. I clienti esistenti di AWS Cloud9 possono continuare a utilizzare il servizio normalmente. [Ulteriori informazioni](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/).

AWS Cloud9 è un ambiente di sviluppo integrato (IDE) basato sul Web che contiene una raccolta di strumenti da utilizzare per codificare, creare, eseguire, testare, eseguire il debug e rilasciare software nel cloud. È possibile utilizzare AWS Cloud9 con AWS SDK per PHP per scrivere ed eseguire il codice PHP utilizzando un browser. AWS Cloud9 include strumenti come un editor di codice e un terminale. Poiché l' AWS Cloud9 IDE è basato sul cloud, puoi lavorare sui tuoi progetti dall'ufficio, da casa o ovunque utilizzando una macchina connessa a Internet. [Per informazioni generali su AWS Cloud9, consulta la Guida per l'AWS Cloud9 utente.](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html)

Segui queste istruzioni per eseguire la configurazione AWS Cloud9 con AWS SDK per PHP:
+  [Passaggio 1: configura Account AWS il tuo AWS Cloud9](#cloud9-php-account) 
+  [Fase 2: Configura il tuo ambiente di AWS Cloud9 sviluppo](#cloud9-php-environment) 
+  [Fase 3: Configurare AWS SDK per PHP](#cloud9-php-sdk) 
+  [Fase 4: Scarica il codice di esempio](#cloud9-php-examples) 
+  [Passaggio 5: Esegui il codice di esempio](#cloud9-php-run) 

## Passaggio 1: configura il tuo Account AWS da utilizzare AWS Cloud9
<a name="cloud9-php-account"></a>

Per utilizzarlo AWS Cloud9, accedi alla AWS Cloud9 console da Console di gestione AWS.

**Nota**  
Se utilizzi AWS IAM Identity Center per autenticarti, potresti dover aggiungere l'autorizzazione richiesta di `iam:ListInstanceProfilesForRole` alla policy associata all'utente nella console IAM.

Per configurare un'entità IAM nel tuo AWS account per accedere AWS Cloud9 e accedere alla AWS Cloud9 console, consulta [Team Setup AWS Cloud9 nella Guida per](https://docs.aws.amazon.com/cloud9/latest/user-guide/setup.html) l'*AWS Cloud9 utente*.

## Fase 2: configura il tuo ambiente di AWS Cloud9 sviluppo
<a name="cloud9-php-environment"></a>

Dopo aver effettuato l'accesso alla AWS Cloud9 console, utilizza la console per creare un ambiente di AWS Cloud9 sviluppo. Dopo aver creato l'ambiente, AWS Cloud9 apre l'IDE per quell'ambiente.

Per i dettagli, consulta [Creazione di un ambiente AWS Cloud9 nella](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment.html) *Guida AWS Cloud9 per l'utente*.

**Nota**  
Dal momento che stai creando l'ambiente nella console per la prima volta, ti consigliamo di scegliere l'opzione **Create a new instance for environment (EC2) (Crea una nuova istanza per l'ambiente (EC2))**. Questa opzione indica AWS Cloud9 di creare un ambiente, avviare un'istanza Amazon EC2 e quindi connettere la nuova istanza al nuovo ambiente. Questo è il modo più veloce per iniziare a usare AWS Cloud9.

Apri il terminale se non è già aperto nell'IDE. Nella barra del menu nell'IDE, scegli **Window, New Terminal (Finestra, Nuovo terminale)**. È possibile utilizzare la finestra del terminale per installare strumenti e creare applicazioni.

## Fase 3: Configurare AWS SDK per PHP
<a name="cloud9-php-sdk"></a>

Dopo aver AWS Cloud9 aperto l'IDE per il tuo ambiente di sviluppo, usa la finestra del terminale per configurarlo AWS SDK per PHP nel tuo ambiente.

 Composer è il metodo consigliato per installare. AWS SDK per PHP Composer è uno strumento per PHP in grado di gestire e installare le dipendenze del progetto.

Per ulteriori informazioni su come installare Composer, configurare il caricamento automatico e seguire le altre best practice per la definizione delle dipendenze, consulta [getcomposer.org](http://getcomposer.org).

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

Se Composer non è già presente nel progetto, scarica e installa Composer dalla pagina [Scarica](http://getcomposer.org/download) Composer.
+ Per **Windows**, seguite le istruzioni di Windows Installer.
+ Per **Linux**, segui le istruzioni di installazione della riga di comando.

### Aggiungi AWS SDK per PHP come dipendenza tramite Composer
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

Se [Composer è già installato globalmente](https://getcomposer.org/doc/00-intro.md#globally) sul sistema, esegui quanto segue nella directory di base del progetto per installarlo AWS SDK per PHP come dipendenza:

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

Altrimenti, digitate questo comando Composer per installare la versione più recente di AWS SDK per PHP come dipendenza.

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

### Aggiungi l'autoloader ai tuoi script php
<a name="add-autoloader-to-your-php-scripts"></a>

L'installazione di Composer crea diverse cartelle e file nell'ambiente. Il file principale che utilizzerai è `autoload.php`, che si trova nella cartella `vendor` dell'ambiente.

Per utilizzarli AWS SDK per PHP nei tuoi script, includi il caricatore automatico negli script, come segue.

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

## Passaggio 4: Scarica il codice di esempio
<a name="cloud9-php-examples"></a>

Usa la finestra del terminale per scaricare il codice di esempio da utilizzare AWS SDK per PHP nell'ambiente di AWS Cloud9 sviluppo.

Per scaricare una copia di tutti gli esempi di codice utilizzati nella documentazione ufficiale dell' AWS SDK nella directory principale dell'ambiente, esegui il comando seguente:

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

Gli esempi di codice per si AWS SDK per PHP trovano nella `ENVIRONMENT_NAME/aws-doc-sdk-examples/php` directory, dove `ENVIRONMENT_NAME` è riportato il nome dell'ambiente di sviluppo.

Per seguire l'utilizzo di un esempio di Amazon S3, consigliamo di iniziare con un esempio di codice. `ENVIRONMENT_NAME/aws-doc-sdk-examples/php/example_code/s3/ListBuckets.php` Questo esempio elencherà i tuoi bucket Amazon S3. Usa la finestra del terminale per accedere alla `s3` directory ed elencare i file.

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

Per aprire il file AWS Cloud9, è possibile fare clic `ListBuckets.php` direttamente nella finestra del terminale.

Per ulteriore assistenza nella comprensione degli esempi di codice, vedi [Esempi di AWS SDK per PHP codice](examples_index.md).

## Passaggio 5: Esegui codice di esempio
<a name="cloud9-php-run"></a>

Per eseguire il codice nel tuo ambiente di AWS Cloud9 sviluppo, scegli il pulsante **Esegui** nella barra dei menu in alto. AWS Cloud9 rileva automaticamente l'estensione del `.php` file e utilizza il runner **PHP (server web integrato)** per eseguire il codice. Tuttavia, per questo esempio vogliamo effettivamente l'opzione **PHP (). `cli`** Per ulteriori informazioni sull'esecuzione del codice in AWS Cloud9, consulta [Run Your Code](https://docs.aws.amazon.com/cloud9/latest/user-guide/build-run-debug.html#build-run-debug-run) nella *Guida per l'AWS Cloud9 utente*.

Nella schermata seguente, prendi nota di queste aree di base:
+ 1: Esegui. Il pulsante **Esegui** si trova nella barra dei menu in alto. Si apre una nuova scheda per i risultati. 
**Nota**  
Puoi anche creare manualmente nuove configurazioni di esecuzione. Nella barra dei menu, selezionare **Run (Esegui)**, **Run Configurations (Configurazioni esecuzione)**, **New Run Configuration (Nuova configurazione esecuzione)**.
+ 2: Comando. AWS Cloud9 compila la casella di testo **Comando** con il percorso e il nome del file eseguito. Se il codice prevede che vengano passati parametri della riga di comando, questi possono essere aggiunti alla riga di comando nello stesso modo in cui si farebbe eseguendo il codice in una finestra di terminale.
+ 3: Runner. AWS Cloud9 rileva che l'estensione del file è `.php` e seleziona il **PHP (server web integrato)** Runner per eseguire il codice. Seleziona invece **PHP (`cli`)** per eseguire questo esempio.

![\[Scegliendo Esegui dalla barra dei menu in alto dell' AWS Cloud9 IDE si apre una nuova scheda con la casella Comando popolata e il runner PHP già selezionato.\]](http://docs.aws.amazon.com/it_it/sdk-for-php/v3/developer-guide/images/cloud9_runconfig.png)


Qualsiasi output generato dal codice in esecuzione viene visualizzato nella scheda.