Service-Clients für die AWS SDK für PHP Version 3 extern konfigurieren - AWS SDK für PHP

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.

Service-Clients für die AWS SDK für PHP Version 3 extern konfigurieren

Viele Konfigurationseinstellungen können außerhalb Ihres Codes bearbeitet werden. Die meisten Konfigurationseinstellungen können entweder als Umgebungsvariablen oder in einer separaten gemeinsam genutzten AWS config Datei festgelegt werden. Die AWS gemeinsam genutzte config Datei kann separate Einstellungssätze, sogenannte Profile, enthalten, um unterschiedliche Konfigurationen für verschiedene Umgebungen oder Tests bereitzustellen. Eine vollständige Beschreibung der gemeinsam AWS genutzten credentials Dateien config und Dateien finden Sie im Referenzhandbuch zu Tools AWS SDKs und Tools.

Die meisten Umgebungsvariablen und Einstellungen für gemeinsam genutzte config Dateien sind standardisiert und werden von allen AWS SDKs Tools gemeinsam genutzt, um konsistente Funktionen in verschiedenen Programmiersprachen und Anwendungen zu gewährleisten.

Alle Einstellungen, die das SDK anhand der Umgebungsvariablen oder Konfigurationsdateien auflösen kann, finden Sie in der Referenz zu Einstellungen im Referenzhandbuch AWS SDKs und im Tools-Referenzhandbuch.

Kette von Konfigurationsanbietern für die Client-Konfiguration

Das SDK sucht an mehreren Stellen (oder Quellen) nach Konfigurationswerten.

  1. Jede explizite Einstellung, die im Code oder auf einem Service-Client selbst festgelegt ist, hat Vorrang vor allen anderen Einstellungen.

  2. Umgebungsvariablen

    • Einzelheiten zum Setzen von Umgebungsvariablen finden Sie unter Umgebungsvariablen im Referenzhandbuch AWS SDKs und im Tools-Referenzhandbuch.

    • Beachten Sie, dass Sie Umgebungsvariablen für eine Shell auf verschiedenen Gültigkeitsebenen konfigurieren können: systemweit, benutzerweit und für eine bestimmte Terminalsitzung.

  3. Geteilte Dateien und Dateien config credentials

  4. Jeder Standardwert, der vom SDK-Quellcode selbst bereitgestellt wird, wird zuletzt verwendet.

    • Für einige Eigenschaften, wie z. B. Region, gibt es keine Standardeinstellung. Sie müssen sie entweder explizit im Code, in einer Umgebungseinstellung oder in der gemeinsam genutzten config Datei angeben. Wenn das SDK die erforderliche Konfiguration nicht auflösen kann, können API-Anfragen zur Laufzeit fehlschlagen.

Neben dieser allgemeinen Konfigurationskette verwendet AWS SDK für PHP Version 3 auch spezialisierte Anbieterketten, darunter die Anbieterkette für Anmeldeinformationen und die AWS-Region Auflösungskette. Diese spezialisierten Ketten fügen zusätzliche Anbieter hinzu, die die Umgebung berücksichtigen, in der das SDK ausgeführt wird. Zum Beispiel in einem Container oder einer EC2 Instanz.

Erstellen Sie einen Service-Client, der mit externen Einstellungen konfiguriert wurde

Sie müssen in Ihrer Anwendung einen Service-Client erstellen, um mit einem zu kommunizieren AWS-Service. Serviceclients sind Ihre unverzichtbare Verbindung zu AWS-Services ihnen. Sie kümmern sich um alle komplexen Kommunikationsdetails, sodass Sie sich keine Gedanken über sie machen müssen. Sie kümmern sich automatisch um wichtige Aufgaben wie Sicherheit, Fehlerbehandlung und Wiederholungen, sodass Sie sich auf die Erstellung Ihrer Anwendung konzentrieren können, anstatt sich um technische Komplikationen zu kümmern.

Konstruieren Sie einen Service-Client mit einem Konstruktor ohne Parameter

Wenn alle benötigten Konfigurationseinstellungen aus externen Quellen stammen, können Sie einen Dienstclient erstellen, indem Sie einen leeren Konstruktor verwenden:

require 'vendor/autoload.php'; use Aws\S3\S3Client; $s3 = new S3Client([]);

Der vorherige Codeausschnitt erstellt eine Instanz. S3Client Während der Erstellung durchsucht das SDK die Kette der Konfigurationsanbieter nach Einstellungen. Sobald das SDK einen Einstellungswert gefunden hat, verwendet es den Wert.

Die AWS-Region Standardanbieterkette und die Standard-Anbieterkette für Anmeldeinformationen werden ebenfalls im Erstellungsprozess verwendet. Irgendwo in der Kette muss das SDK die AWS-Region zu verwendenden Einstellungen auflösen und Einstellungen finden, die es ermöglichen, Anmeldeinformationen für Signieranfragen abzurufen. Wenn das SDK diese Werte nicht findet, schlägt die Client-Erstellung fehl.

AWS SDK für PHP Umgebungsvariablen der Version 3

Neben den SDK-übergreifenden Einstellungen, die von den meisten unterstützt werden AWS SDKs, arbeitet AWS SDK für PHP Version 3 mit den folgenden Umgebungsvariablen:

AWS_SDK_LOAD_NONDEFAULT_CONFIG

Wenn diese Umgebungsvariable gesetzt ist, weist sie das SDK an, zusätzlich zu den Datei (en) auch Anmeldeinformationen aus der AWS config Datei (~/.aws/config) zu laden. credentials ~/.aws/credential

AWS_SDK_UA_APP_ID

Legt eine benutzerdefinierte Anwendungs-ID fest, die in den User-Agent-Header für Anfragen des SDK aufgenommen wird.

AWS_SUPPRESS_PHP_DEPRECATION_WARNING

Wenn dieser Wert auf true gesetzt ist, werden Warnungen vor PHP-Verwarnungen unterdrückt, die das SDK möglicherweise generiert.