Configuration du Région AWS pour la AWS SDK pour PHP version 3 - AWS SDK pour PHP
Chaîne de résolution régionaleBonnes pratiques

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.

Configuration du Région AWS pour la AWS SDK pour PHP version 3

Les clients du SDK se connectent à un Service AWS in spécifique Région AWS que vous spécifiez lors de la création du client. Cette configuration permet à votre application d'interagir avec AWS les ressources de cette zone géographique. Lorsque vous créez un client de service sans définir explicitement de région, le SDK utilise la région par défaut de votre configuration externe.

Chaîne de résolution régionale

La AWS SDK pour PHP version 3 utilise l'ordre suivant pour déterminer la région utilisée par un client de service :

  1. Région fournie dans le code : si vous définissez explicitement la région dans les options du constructeur du client, celle-ci a priorité sur toutes les autres sources.

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

  2. Variables d'environnement : si aucune région n'est fournie dans le code, le SDK vérifie la présence de ces variables d'environnement dans l'ordre suivant :

    • AWS_REGION

    • AWS_DEFAULT_REGION

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

  3. AWS fichiers de configuration : si aucune variable d'environnement de région n'est définie, le SDK vérifie les AWS fichiers de configuration :

    1. Le SDK recherche ~/.aws/config (ou l'emplacement spécifié par la variable d'AWS_CONFIG_FILEenvironnement)

    2. Le SDK examine le paramètre de région dans le profil spécifié par la variable d'AWS_PROFILEenvironnement

    3. Si non AWS_PROFILE est spécifié, le SDK utilise le profil « par défaut »

    Par exemple, supposons que nous disposions des paramètres de fichier de configuration suivants :

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

[profile production]
region = eu-central-1

    Si la variable d'AWS_PROFILEenvironnement est définie avec la valeur « production », les clients utilisent leeu-central-1 Region. S'il n'existe aucune variable d'AWS_PROFILEenvironnement, les clients utilisent la eu-west-1 région.

  4. Si le SDK ne trouve aucune valeur de région dans l'une des sources ci-dessus, il lance une exception car une valeur de région est un paramètre obligatoire pour un client de service.

Bonnes pratiques

Tenez compte des meilleures pratiques suivantes lorsque vous travaillez avec des régions dans la AWS SDK pour PHP version 3 :

Définissez explicitement la région dans le code de production

Pour les applications de production, nous vous recommandons de définir explicitement la région dans votre code plutôt que de vous fier aux variables d'environnement ou auconfig. Cela rend votre code plus prévisible et moins dépendant de la configuration externe.

Utiliser des variables d'environnement pour le développement et les tests

Pour les environnements de développement et de test, l'utilisation de variables d'environnement permet une plus grande flexibilité sans modifier le code.

Utiliser des profils pour plusieurs environnements

Si votre application doit fonctionner avec plusieurs AWS environnements, pensez à utiliser différents profils dans votre AWS config fichier et à passer de l'un à l'autre selon vos besoins.