Regione AWS Impostazione della AWS SDK per PHP versione 3 - AWS SDK per PHP
Catena di risoluzione della regioneBest practice

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

Regione AWS Impostazione della AWS SDK per PHP versione 3

I client SDK si connettono Servizio AWS a un indirizzo specifico Regione AWS specificato al momento della creazione del client. Questa configurazione consente all'applicazione di interagire con AWS le risorse in quell'area geografica. Quando crei un client di servizio senza impostare esplicitamente una regione, l'SDK utilizza la regione predefinita della configurazione esterna.

Catena di risoluzione della regione

La AWS SDK per PHP versione 3 utilizza il seguente ordine per determinare la regione utilizzata da un client di servizio:

  1. Regione fornita nel codice: se si imposta in modo esplicito la regione nelle opzioni del costruttore del client, questa ha la precedenza su tutte le altre fonti.

    $s3Client = new Aws\S3\S3Client([
    'region' => 'us-west-2'
]);

  2. Variabili di ambiente: se nel codice non viene fornita alcuna regione, l'SDK verifica le seguenti variabili di ambiente nell'ordine:

    • AWS_REGION

    • AWS_DEFAULT_REGION

    # Example of setting Region through environment variables.
export AWS_REGION=us-east-1

  3. AWS file di configurazione: se non è impostata alcuna variabile di ambiente Region, l'SDK controlla i file di configurazione: AWS

    1. L'SDK cerca ~/.aws/config (o la posizione specificata dalla variabile di ambiente) AWS_CONFIG_FILE

    2. L'SDK esamina l'impostazione della regione all'interno del profilo specificato dalla variabile di ambiente AWS_PROFILE

    3. Se non AWS_PROFILE viene specificato no, l'SDK utilizza il profilo «predefinito»

    Ad esempio, supponiamo di avere le seguenti impostazioni del file di configurazione:

    # Example ~/.aws/config file.
[default]
region = eu-west-1

[profile production]
region = eu-central-1

    Se la variabile di AWS_PROFILE ambiente è impostata con un valore di «produzione», i client utilizzano ileu-central-1 Region. Se non esiste alcuna variabile di AWS_PROFILE ambiente, i client utilizzano la eu-west-1 regione.

  4. Se l'SDK non trova alcun valore Region in nessuna delle fonti precedenti, genera un'eccezione poiché un valore Region è un'impostazione obbligatoria per un client di servizio.

Best practice

Considerate le seguenti best practice quando lavorate con le regioni nella AWS SDK per PHP versione 3:

Imposta esplicitamente la regione nel codice di produzione

Per le applicazioni di produzione, consigliamo di impostare in modo esplicito la regione nel codice anziché affidarsi alle variabili di ambiente o al. config Questo rende il codice più prevedibile e meno dipendente dalla configurazione esterna.

Usa le variabili di ambiente per lo sviluppo e il test

Per gli ambienti di sviluppo e test, l'utilizzo di variabili di ambiente consente una maggiore flessibilità senza modificare il codice.

Usa i profili per più ambienti

Se la tua applicazione deve funzionare con più AWS ambienti, prendi in considerazione l'utilizzo di profili diversi nel AWS config file e il passaggio da uno all'altro secondo necessità.