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à.
Configurazione esterna dei client di servizio per la AWS SDK per PHP versione 3
Molte impostazioni di configurazione possono essere gestite al di fuori del codice. La maggior parte delle impostazioni di configurazione può essere impostata come variabili di ambiente o in un AWS config file condiviso separato. Il config file AWS
condiviso può mantenere set di impostazioni separati, chiamati profili, per fornire configurazioni diverse per ambienti o test diversi. Per una discussione completa sugli elementi AWS
condivisi config e sui credentials file, consulta la Guida di riferimento di AWS SDKs and Tools.
La maggior parte delle variabili di ambiente e delle impostazioni dei config file condivisi sono standardizzate e condivise tra tutti AWS SDKs gli strumenti per supportare funzionalità coerenti tra diversi linguaggi di programmazione e applicazioni.
Per visualizzare tutte le impostazioni che l'SDK è in grado di risolvere a partire dalle variabili di ambiente o dai file di configurazione, consulta il riferimento alle impostazioni nella AWS SDKs and Tools Reference Guide.
Catena di provider di configurazione per la configurazione del client
L'SDK controlla diverse posizioni (o fonti) per trovare i valori di configurazione.
-
Qualsiasi impostazione esplicita impostata nel codice o su un client di servizio stesso ha la precedenza su qualsiasi altra cosa.
-
Variabili di ambiente
-
Per i dettagli sull'impostazione delle variabili di ambiente, consultate le variabili di ambiente nella Guida di riferimento agli strumenti AWS SDKs e agli strumenti.
-
Nota che puoi configurare le variabili di ambiente per una shell a diversi livelli di ambito: a livello di sistema, a livello di utente e per una sessione di terminale specifica.
-
-
Condivisi e file
configcredentials-
Per i dettagli sulla configurazione di questi file, consulta la Guida di riferimento Condivisi
configAWS SDKs ecredentialsfile in and Tools.
-
-
Qualsiasi valore predefinito fornito dal codice sorgente SDK stesso viene utilizzato per ultimo.
-
Alcune proprietà, come Region, non hanno un valore predefinito. È necessario specificarle esplicitamente nel codice, in un'impostazione di ambiente o nel
configfile condiviso. Se l'SDK non è in grado di risolvere la configurazione richiesta, le richieste API possono avere esito negativo in fase di esecuzione.
-
Oltre a questa catena di configurazione generale, la AWS SDK per PHP versione 3 utilizza anche catene di provider specializzate, tra cui la catena di fornitori di credenziali e la catena di Regione AWS risoluzione. Queste catene specializzate aggiungono provider aggiuntivi che tengono conto dell'ambiente in cui è in esecuzione l'SDK. Ad esempio, in un contenitore o in un' EC2 istanza.
Crea un client di servizio configurato utilizzando impostazioni esterne
È necessario creare un client di servizio nell'applicazione per parlare con un Servizio AWS. I client di servizio sono il tuo punto di Servizi AWS contatto essenziale con cui gestire tutti i complessi dettagli di comunicazione in modo da non doverti preoccupare di loro. Si occupano automaticamente di attività importanti come la sicurezza, la gestione degli errori e i nuovi tentativi, consentendovi di concentrarvi sulla creazione dell'applicazione piuttosto che sulle complicazioni tecniche.
Costruisci un client di servizio utilizzando un costruttore senza parametri
Se tutte le impostazioni di configurazione necessarie provengono da fonti esterne, puoi creare un client di servizio utilizzando un costruttore vuoto:
require 'vendor/autoload.php'; use Aws\S3\S3Client; $s3 = new S3Client([]);
Il frammento di codice precedente crea un'istanza. S3Client Durante la creazione, l'SDK esamina le impostazioni nella catena di provider di configurazione. Una volta che l'SDK trova un valore di impostazione, lo utilizza.
Nel processo Regione AWS di creazione verranno utilizzate anche la catena di provider predefinita e la catena di fornitori di credenziali predefinita. In qualche punto della catena, l'SDK deve definire le impostazioni da utilizzare e trovare le impostazioni che gli consentano di recuperare le credenziali per la firma delle richieste. Regione AWS Se l'SDK non riesce a trovare questi valori, la creazione del client fallisce.
AWS SDK per PHP Variabili di ambiente della versione 3
Oltre alle impostazioni cross-sdk supportate dalla maggior parte AWS SDKs, la AWS SDK per PHP versione 3 funziona con le seguenti variabili di ambiente:
- AWS_SDK_LOAD_NONDEFAULT_CONFIG
-
Quando impostata, questa variabile di ambiente indica all'SDK di caricare le credenziali dal file () oltre ai file. AWS
config~/.aws/configcredentials~/.aws/credential - AWS_SDK_UA_APP_ID
-
Imposta un identificatore di applicazione personalizzato che viene incluso nell'intestazione User-Agent per le richieste effettuate dall'SDK.
- AWS_SUPPRESS_PHP_DEPRECATION_WARNING
-
Se impostato su true, sopprime gli avvisi di deprecazione PHP che l'SDK potrebbe generare.