Einstellung der AWS-Region für die AWS SDK für PHP Version 3 - AWS SDK für PHP
Auflösungskette für RegionenBewährte Methoden

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Einstellung der AWS-Region für die AWS SDK für PHP Version 3

SDK-Clients stellen eine Verbindung zu einem bestimmten AWS-Service in einem bestimmten Bereich her AWS-Region , den Sie bei der Erstellung des Clients angeben. Diese Konfiguration ermöglicht es Ihrer Anwendung, mit AWS Ressourcen in diesem geografischen Gebiet zu interagieren. Wenn Sie einen Service-Client erstellen, ohne explizit eine Region festzulegen, verwendet das SDK die Standardregion aus Ihrer externen Konfiguration.

Auflösungskette für Regionen

AWS SDK für PHP Version 3 verwendet die folgende Reihenfolge, um zu bestimmen, welche Region ein Service-Client verwendet:

  1. Im Code angegebene Region — Wenn Sie die Region in den Client-Konstruktoroptionen explizit festlegen, hat dies Vorrang vor allen anderen Quellen.

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

  2. Umgebungsvariablen — Wenn im Code keine Region angegeben ist, sucht das SDK der Reihe nach nach diesen Umgebungsvariablen:

    • AWS_REGION

    • AWS_DEFAULT_REGION

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

  3. AWS Konfigurationsdateien — Wenn keine Umgebungsvariablen für die Region festgelegt sind, überprüft das SDK die Konfigurationsdateien: AWS

    1. Das SDK sucht in ~/.aws/config (oder in dem in der AWS_CONFIG_FILE Umgebungsvariablen angegebenen Speicherort)

    2. Das SDK untersucht die Regionseinstellung innerhalb des durch die AWS_PROFILE Umgebungsvariable angegebenen Profils

    3. Wenn kein Profil angegeben AWS_PROFILE ist, verwendet das SDK das „Standard“ -Profil

    Nehmen wir als Beispiel an, dass wir die folgenden Einstellungen für die Konfigurationsdatei haben:

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

[profile production]
region = eu-central-1

    Wenn für die AWS_PROFILE Umgebungsvariable der Wert „production“ festgelegt ist, verwenden Clients deneu-central-1 Region. Wenn keine AWS_PROFILE Umgebungsvariable vorhanden ist, verwenden Clients die eu-west-1 Region.

  4. Wenn das SDK in keiner der oben genannten Quellen einen Regionswert findet, löst es eine Ausnahme aus, da ein Regionswert eine erforderliche Einstellung für einen Service-Client ist.

Bewährte Methoden

Beachten Sie bei der Arbeit mit Regionen in AWS SDK für PHP Version 3 die folgenden bewährten Methoden:

Legen Sie die Region explizit im Produktionscode fest

Für Produktionsanwendungen empfehlen wir, die Region explizit in Ihrem Code festzulegen, anstatt sich auf Umgebungsvariablen oder die zu verlassenconfig. Dadurch wird Ihr Code vorhersehbarer und ist weniger von der externen Konfiguration abhängig.

Verwenden Sie Umgebungsvariablen für Entwicklung und Tests

In Entwicklungs- und Testumgebungen ermöglicht die Verwendung von Umgebungsvariablen mehr Flexibilität, ohne den Code zu ändern.

Verwenden Sie Profile für mehrere Umgebungen

Wenn Ihre Anwendung mit mehreren AWS Umgebungen arbeiten muss, sollten Sie erwägen, unterschiedliche Profile in Ihrer AWS config Datei zu verwenden und bei Bedarf zwischen diesen zu wechseln.