Configurazione per la AWS SDK for PHP versione 3

Le opzioni del costruttore client possono essere fornite in un costruttore client o fornite alla Aws\Sdkclasse. La vasta gamma di opzioni fornite a uno specifico tipo di client può variare in base a quale client si sta creando. Queste opzioni personalizzate per la configurazione di client sono descritte nella documentazione API di ogni client.

Nota che alcune opzioni di configurazione controlleranno e utilizzeranno i valori predefiniti basati su variabili di ambiente o su un AWS file di configurazione. Per impostazione predefinita, il file di configurazione da controllare sarà .aws/config nella home directory, comunemente ~/.aws/config. Tuttavia, è possibile utilizzare la variabile d'ambiente AWS_CONFIG_FILE per impostare la posizione del file di configurazione predefinito. Ad esempio, questo può essere utile se si limita l'accesso ai file a determinate directory con. open_basedir

Per ulteriori informazioni sulla posizione e sulla formattazione dei credentials file condivisi AWS config e condivisi, consulta Configurazione nella Guida di riferimento agli AWSSDK e agli strumenti.

Per i dettagli su tutte le impostazioni di configurazione globali che puoi impostare nei file di AWS configurazione o come variabili di ambiente, consulta il riferimento alle impostazioni di configurazione e autenticazione nella Guida di riferimento agli AWSSDK e agli strumenti.

L'esempio seguente mostra come passare opzioni a un costruttore di client Amazon S3.

use Aws\S3\S3Client;

$options = [
    'region'            => 'us-west-2',
    'version'           => '2006-03-01',
    'signature_version' => 'v4'
];

$s3Client = new S3Client($options);

Consulta la guida di utilizzo di base per ulteriori informazioni su come costruire client.

api_provider

Un PHP chiamabile che accetta un tipo, servizio e argomento versione e restituisce un array di dati di configurazione corrispondenti. Il valore del tipo può essere api, waiter o paginator.

Per impostazione predefinita, l'SDK usa un'istanza di Aws\Api\FileSystemApiProvider che carica i file dell'API dalla cartella src/data dell'SDK.

credenziali

Passa un oggetto Aws\Credentials\CredentialsInterface per utilizzare le credenziali di un'istanza specifica. Quanto segue specifica che deve essere utilizzato il provider di credenziali IAM Identity Center. Questo provider è noto anche come provider di credenziali SSO.

$credentials = Aws\Credentials\CredentialProvider::sso('profile default');

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

Se utilizzi un profilo denominato, sostituisci il nome del tuo profilo con 'default' nell'esempio precedente. Per ulteriori informazioni sulla configurazione di profili denominati, consulta Condivisi config e credentials file nella Guida di riferimento agli AWS SDK e agli strumenti.

Se non specifichi un provider di credenziali da utilizzare e ti affidi alla catena di fornitori di credenziali, il messaggio di errore derivante dall'autenticazione non riuscita è in genere generico. Viene generato dall'ultimo provider nell'elenco delle fonti controllate per verificare la presenza di credenziali valide, che potrebbe non essere il provider che si sta tentando di utilizzare. Quando si specifica il provider di credenziali da utilizzare, qualsiasi messaggio di errore risultante è più utile e pertinente perché proviene solo da quel provider. Per ulteriori informazioni sulla catena di fonti in cui è stata verificata la presenza di credenziali, consulta Credential provider chain nella Guida di riferimento agli AWSSDK and Tools.

Passa false per utilizzare credenziali null e non firmare richieste.

$s3 = new Aws\S3\S3Client([
    'region'      => 'us-west-2',
    'credentials' => false
]);

Passa una funzione di provider di credenziali chiamabile per creare credenziali utilizzando una funzione.

use Aws\Credentials\CredentialProvider;

// Only load credentials from environment variables
$provider = CredentialProvider::env();

$s3 = new Aws\S3\S3Client([
    'region'      => 'us-west-2',
    'credentials' => $provider
]);

Trasferisce le credenziali nella cache a un'istanza di Aws\CacheInterface per memorizzare nella cache i valori restituiti dalla catena di provider predefinita su più processi.

use Aws\Credentials\CredentialProvider;
use Aws\PsrCacheAdapter;
use Symfony\Component\Cache\Adapter\FilesystemAdapter;


$cache = new PsrCacheAdapter(new FilesystemAdapter);
$provider = CredentialProvider::defaultProvider();
$cachedProvider = CredentialProvider::cache($provider, $cache);

$s3 = new Aws\S3\S3Client([
    'region' => 'us-west-2',
    'credentials' => $cachedProvider
]);

Puoi trovare ulteriori informazioni sulla fornitura di credenziali a un client nella guida Credenziali per la versione 3. AWS SDK for PHP

debug

Emette le informazioni di debug su ogni trasferimento. Le informazioni di debug contengono informazioni su ogni modifica dello stato di una transazione e vengono preparate e inviate tramite la rete. L'output di debug include anche informazioni sul gestore HTTP specifico utilizzato da un client (ad esempio, debug cURL output).

Imposta su true per visualizzare le informazioni di debug durante l'invio delle richieste.

$s3 = new Aws\S3\S3Client([
    'region'  => 'us-west-2',
    'debug'   => true
]);

// Perform an operation to see the debug output
$s3->listBuckets();

In alternativa, puoi fornire un array associativo con le seguenti chiavi.

$s3 = new Aws\S3\S3Client([
    'region'  => 'us-west-2',
    'debug'   => [
        'logfn'        => function ($msg) { echo $msg . "\n"; },
        'stream_size'  => 0,
        'scrub_auth'   => true,
        'http'         => true,
        'auth_headers' => [
            'X-My-Secret-Header' => '[REDACTED]',
        ],
        'auth_strings' => [
            '/SuperSecret=[A-Za-z0-9]{20}/i' => 'SuperSecret=[REDACTED]',
        ],
    ]
]);

// Perform an operation to see the debug output
$s3->listBuckets();

statistiche

Associa le statistiche di trasferimento agli errori e ai risultati restituiti dalle operazioni dell'SDK.

Imposta su true per raccogliere le statistiche di trasferimento sulle richieste inviate.

$s3 = new Aws\S3\S3Client([
    'region'  => 'us-west-2',
    'stats'   => true
]);

// Perform an operation
$result = $s3->listBuckets();
// Inspect the stats
$stats = $result['@metadata']['transferStats'];

In alternativa, puoi fornire un array associativo con le seguenti chiavi.

$s3 = new Aws\S3\S3Client([
    'region'  => 'us-west-2',
    'stats'   => [
        'retries'      => true,
        'timer'        => false,
        'http'         => true,
    ]
]);

// Perform an operation
$result = $s3->listBuckets();
// Inspect the HTTP transfer stats
$stats = $result['@metadata']['transferStats']['http'];
// Inspect the number of retries attempted
$stats = $result['@metadata']['transferStats']['retries_attempted'];
// Inspect the total backoff delay inserted between retries
$stats = $result['@metadata']['transferStats']['total_retry_delay'];

endpoint

L'URI completo del servizio Web. Ciò è necessario per i servizi, ad esempio quelli che utilizzano AWS Elemental MediaConvertendpoint specifici dell'account. Per questi servizi, richiedi questo endpoint utilizzando il metodo. describeEndpoints

Questo è necessario solo quando ci si connette a un endpoint personalizzato (ad esempio, una versione locale di Amazon S3 o Amazon DynamoDB Local).

Ecco un esempio di connessione ad Amazon DynamoDB Local:

$client = new Aws\DynamoDb\DynamoDbClient([
    'version'  => '2012-08-10',
    'region'   => 'us-east-1',
    'endpoint' => 'http://localhost:8000'
]);

Consulta le AWSregioni e gli endpoint per un elenco delle AWS regioni e degli endpoint disponibili.

endpoint_provider

Un'istanza opzionale di EndpointProvider V2 o PHP callable che accetta un hash di opzioni, tra cui una chiave «service» e «region». Restituisce NULL o un hash di dati di endpoint, di cui la chiave "endpoint" è obbligatoria.

Ecco un esempio di come creare un provider di endpoint minimi.

$provider = function (array $params) {
    if ($params['service'] == 'foo') {
        return ['endpoint' => $params['region'] . '.example.com'];
    }
    // Return null when the provider cannot handle the parameters
    return null;
});

endpoint_discovery

Il rilevamento endpoint identifica e si connette all'endpoint corretto per un'API di servizio che supporta il rilevamento di endpoint. Per servizi che supportano ma non richiedono il rilevamento di endpoint, abilita endpoint_discovery durante la creazione client. Se un servizio non supporta il rilevamento di endpoint questa configurazione viene ignorata.

Aws\EndpointDiscovery\ConfigurationInterface

Un provider di configurazione opzionale che abilita la connessione automatica all'endpoint appropriato di un'API di servizio per operazioni specificate dal servizio.

L'oggetto Aws\EndpointDiscovery\Configuration accetta due opzioni, incluso un valore booleano, "abilitato", che indica se il rilevamento di endpoint è abilitato e un "cache_limit" intero che indica il numero massimo di chiavi nella cache di endpoint.

Per ogni client creato, passa un oggetto Aws\EndpointDiscovery\Configuration per utilizzare una configurazione specifica per il rilevamento di endpoint.

use Aws\EndpointDiscovery\Configuration;
use Aws\S3\S3Client;

$enabled = true;
$cache_limit = 1000;

$config = new Aws\EndpointDiscovery\Configuration (
    $enabled,
    $cache_limit
);

$s3 = new Aws\S3\S3Client([
    'region' => 'us-east-2',
    'endpoint_discovery' => $config,

]);

Passa un'istanza di Aws\CacheInterface per memorizzare nella cache i valori restituiti dal rilevamento di endpoint su più processi.

use Aws\DoctrineCacheAdapter;
use Aws\S3\S3Client;
use Doctrine\Common\Cache\ApcuCache;

$s3 = new S3Client([
    'region'      => 'us-west-2',
    'endpoint_discovery' => new DoctrineCacheAdapter(new ApcuCache),
]);

Passa un array al rilevamento di endpoint.

use Aws\S3\S3Client;

$s3 = new S3Client([
    'region'      => 'us-west-2',
    'endpoint_discovery' => [
        'enabled' => true,
        'cache_limit' => 1000
    ],
]);

handler

Un gestore che accetta un oggetto di comando e un oggetto di richiesta e che restituisce una promessa (GuzzleHttp\Promise\PromiseInterface) che viene soddisfatta con un oggetto Aws\ResultInterface o rifiutata con un Aws\Exception\AwsException. Un gestore non accetta un gestore successivo poiché è terminale e tenuto a soddisfare un comando. Se non viene fornito alcun gestore, viene utilizzato un gestore Guzzle predefinito.

Puoi usare Aws\MockHandler per restituire risultati fittizi o generare eccezioni fittizie. Metti in coda i risultati o le eccezioni e li rimuoverà dalla MockHandler coda in ordine FIFO.

use Aws\Result;
use Aws\MockHandler;
use Aws\DynamoDb\DynamoDbClient;
use Aws\CommandInterface;
use Psr\Http\Message\RequestInterface;
use Aws\Exception\AwsException;

$mock = new MockHandler();

// Return a mocked result
$mock->append(new Result(['foo' => 'bar']));

// You can provide a function to invoke; here we throw a mock exception
$mock->append(function (CommandInterface $cmd, RequestInterface $req) {
    return new AwsException('Mock exception', $cmd);
});

// Create a client with the mock handler
$client = new DynamoDbClient([
    'region' => 'us-east-1',
    'handler' => $mock
]);

// Result object response will contain ['foo' => 'bar']
$result = $client->listTables();

// This will throw the exception that was enqueued
$client->listTables();

http

Impostato su una gamma di opzioni di HTTP che vengono applicate alle richieste e ai trasferimenti HTTP creati tramite l'SDK.

L'SDK supporta le opzioni di configurazione seguenti:

cert

Specifica il certificato lato client formattato PEM.

use Aws\S3\S3Client;

$client = new S3Client([
    'region'  => 'us-west-2',
    'http'    => ['cert' => '/path/to/cert.pem']
]);

use Aws\S3\S3Client;

$client = new S3Client([
    'region'  => 'us-west-2',
    'http'    => [
        'cert' => ['/path/to/cert.pem', 'password']
    ]
]);

connect_timeout

Un float che descrive il numero di secondi da attendere durante il tentativo di connettersi a un server. Utilizza 0 per attendere un periodo di tempo indefinito (comportamento predefinito).

use Aws\DynamoDb\DynamoDbClient;

// Timeout after attempting to connect for 5 seconds
$client = new DynamoDbClient([
    'region'  => 'us-west-2',
    'http'    => [
        'connect_timeout' => 5
    ]
]);

debug

Istruisce il gestore HTTP sottostante di emettere le informazioni di debug. Le informazioni di debug fornite da diversi gestori HTTP possono variare.

decode_content

Istruisce il gestore HTTP sottostante di decomprimere il corpo delle risposte compromesse. Quando non è abilitato, i corpi compressi delle risposte potrebbero essere decompressi con un GuzzleHttp\Psr7\InflateStream.

use Aws\S3\S3Client;
use GuzzleHttp\Psr7\InflateStream;

$client = new S3Client([
    'region'  => 'us-west-2',
    'http'    => ['decode_content' => false],
]);

$result = $client->getObject([
    'Bucket' => 'my-bucket',
    'Key'    => 'massize_gzipped_file.tgz'
]);

$compressedBody = $result['Body']; // This content is still gzipped
$inflatedBody = new InflateStream($result['Body']); // This is now readable

delay

Il numero di ritardo in millisecondi prima dell'invio della richiesta. Questo è spesso usato per inserire un ritardo prima di inviare di nuovo la richiesta.

expect

Questa opzione viene passata tramite il gestore HTTP sottostante. Per impostazione predefinita, l'intestazione Expect: 100-Continue è impostata quando il corpo della richiesta supera 1 MB. true o false abilita o disabilita l'intestazione su tutte le richieste. Se viene utilizzato un intero, solo le richieste con corpi che superano questa impostazione utilizzeranno l'intestazione. Quando utilizzato come un intero, se le dimensioni del corpo non sono note, verrà inviata l'intestazione Expect.

progress

Definisce una funzione da invocare quando vi è un avanzamento del trasferimento. La funzione accetta i seguenti argomenti:

use Aws\S3\S3Client;

$client = new S3Client([
    'region'  => 'us-west-2'
]);

// Apply the http option to a specific command using the "@http"
// command parameter
$result = $client->getObject([
    'Bucket' => 'my-bucket',
    'Key'    => 'large.mov',
    '@http' => [
        'progress' => function ($expectedDl, $dl, $expectedUl, $ul) {
            printf(
                "%s of %s downloaded, %s of %s uploaded.\n",
                $expectedDl,
                $dl,
                $expectedUl,
                $ul
            );
        }
    ]
]);

proxy

Puoi connetterti a un AWS servizio tramite un proxy utilizzando l'opzione. proxy

use Aws\DynamoDb\DynamoDbClient;

// Send requests through a single proxy
$client = new DynamoDbClient([
    'region'  => 'us-west-2',
    'http'    => [
        'proxy' => 'http://192.168.16.1:10'
    ]
]);

// Send requests through a different proxy per scheme
$client = new DynamoDbClient([
    'region'  => 'us-west-2',
    'http'    => [
        'proxy' => [
            'http' => 'tcp://192.168.16.1:10',
            'https' => 'tcp://192.168.16.1:11',
        ]
    ]
]);

Puoi utilizzare la variabile ambiente HTTP_PROXY per configurare un proxy specifico del protocollo "http" e la variabile ambiente HTTPS_PROXY per configurare un proxy specifico "https".

sink

L'opzione sink controlla dove vengono scaricati i dati di risposta di un'operazione.

synchronous

L'opzione synchronous informa il gestore HTTP che desideri bloccare il risultato.

stream

Imposta su true per comunicare al gestore HTTP sottostante che desideri trasmettere il corpo di una risposta dal servizio Web, anziché scaricarlo tutto subito. Ad esempio, questa opzione viene utilizzata nella classe stream wrapper di Amazon S3 per garantire lo streaming dei dati.

timeout

Un float che descrive il timeout della richiesta in secondi. Utilizza 0 per attendere un periodo di tempo indefinito (comportamento predefinito).

use Aws\DynamoDb\DynamoDbClient;

// Timeout after 5 seconds
$client = new DynamoDbClient([
    'region'  => 'us-west-2',
    'http'    => [
        'timeout' => 5
    ]
]);

Verifica

Puoi personalizzare il comportamento di verifica del certificato SSL/TLS dell'SDK tramite l'opzione verify http.

Se il bundle CA non viene individuato per il sistema e ricevi un errore, specifica il percorso di un bundle CA per l'SDK. Se non hai bisogno di un bundle CA specifico, Mozilla fornisce un bundle CA comune che puoi scaricare qui (viene gestito dal servizio maintainer di cURL). Una volta che disponi di un bundle CA su disco, puoi configurare l'impostazione.ini PHP openssl.cafile per puntare al percorso del file, consentendo di omettere l'opzione di richiesta verify. Per ulteriori dettagli sui certificati SSL, consulta il sito Web di cURL.

use Aws\DynamoDb\DynamoDbClient;

// Use a custom CA bundle
$client = new DynamoDbClient([
    'region'  => 'us-west-2',
    'http'    => [
        'verify' => '/path/to/my/cert.pem'
    ]
]);

// Disable SSL/TLS verification
$client = new DynamoDbClient([
    'region'  => 'us-west-2',
    'http'    => [
        'verify' => false
    ]
]);

http_handler

L'opzione http_handler viene utilizzata per integrare l'SDK con altri client HTTP. Un'opzione http_handler è una funzione che accetta un oggetto Psr\Http\Message\RequestInterface e una vasta gamma di opzioni http applicate al comando e restituisce un oggetto GuzzleHttp\Promise\PromiseInterface che viene soddisfatto con un oggetto Psr\Http\Message\ResponseInterface o rifiutato con una vasta gamma dei seguenti dati di eccezione:

L'SDK converte automaticamente l'http_handler dato in una normale opzione handler includendo l'http_handler fornito con un oggetto Aws\WrappedHttpHandler.

Per impostazione predefinita, l'SDK utilizza Guzzle come gestore HTTP. È possibile fornire qui un gestore HTTP diverso o fornire un client Guzzle con le proprie opzioni personalizzate definite.

Impostazione della versione TLS

Un caso d'uso è quello di impostare la versione TLS utilizzata da Guzzle con Curl, supponendo che Curl sia installato nel proprio ambiente. Notare i vincoli di versione Curl per cui la versione di TLS è supportata. Per impostazione predefinita viene utilizzata la versione più recente. Se la versione TLS è impostata in modo esplicito e il server remoto non supporta questa versione, verrà generato un errore anziché utilizzare una versione TLS precedente.

È possibile individuare la versione TLS utilizzata per una determinata operazione client impostando l'opzione client debug su true ed esaminando l'output della connessione SSL. Quella linea potrebbe essere simile a SSL connection using TLSv1.2

Esempio di impostazione di TLS 1.2 con Guzzle 6:

use Aws\DynamoDb\DynamoDbClient;
use Aws\Handler\GuzzleV6\GuzzleHandler;
use GuzzleHttp\Client;

$handler = new GuzzleHandler(
    new Client([
        'curl' => [
            CURLOPT_SSLVERSION => CURL_SSLVERSION_TLSv1_2
        ]
    ])
);

$client = new DynamoDbClient([
    'region'  => 'us-west-2',
    'http_handler' => $handler
]);

profilo

L'opzione «profile» specifica quale profilo utilizzare quando le credenziali vengono create dal file delle AWS credenziali nella directory HOME (in genere). ~/.aws/credentials Questa impostazione sostituisce la variabile ambiente AWS_PROFILE.

// Use the "production" profile from your credentials file
$ec2 = new Aws\Ec2\Ec2Client([
    'version' => '2014-10-01',
    'region'  => 'us-west-2',
    'profile' => 'production'
]);

Vedi Credenziali per la AWS SDK for PHP versione 3 per ulteriori informazioni sulla configurazione delle credenziali e sul formato di file.ini.

Regione

AWSRegione a cui connettersi. Consulta le AWSregioni e gli endpoint per un elenco delle regioni disponibili.

// Set the Region to the EU (Frankfurt) Region
$s3 = new Aws\S3\S3Client([
    'region'  => 'eu-central-1',
    'version' => '2006-03-01'
]);

retries

Configura la modalità nuovi tentativi e il numero massimo di tentativi consentiti per un client. Passa 0 per disabilitare i nuovi tentativi.

Le tre modalità di riprova sono:

La configurazione dei nuovi tentativi consiste nella modalità e nel massimo tentativo da utilizzare per ogni richiesta. La configurazione può essere impostata in un paio di posizioni diverse, nel seguente ordine di precedenza.

Ordine di precedenza

L'ordine di precedenza per la configurazione dei tentativi è il seguente (1 sostituisce 2-3, ecc.):

Variabili di ambiente

Chiavi file di configurazione condiviso

Configurazione del client

L'esempio seguente disabilita i nuovi tentativi per il client Amazon DynamoDB.

// Disable retries by setting "retries" to 0
$client = new Aws\DynamoDb\DynamoDbClient([
    'version' => '2012-08-10',
    'region'  => 'us-west-2',
    'retries' => 0
]);

L'esempio seguente passa in un numero intero, che per impostazione predefinita sarà la modalità legacy con il numero passato di nuovi tentativi

// Disable retries by setting "retries" to 0
$client = new Aws\DynamoDb\DynamoDbClient([
    'version' => '2012-08-10',
    'region'  => 'us-west-2',
    'retries' => 6
]);

oggetto Aws\Retry\Configuration per ripetere la configurazione.

use Aws\EndpointDiscovery\Configuration;
use Aws\S3\S3Client;

$enabled = true;
$cache_limit = 1000;

$config = new Aws\Retry\Configuration('adaptive', 10);

$s3 = new Aws\S3\S3Client([
    'region' => 'us-east-2',
    'retries' => $config,
]);

Questo esempio passa in un array per la configurazione dei nuovi tentativi.

use Aws\S3\S3Client;

$s3 = new S3Client([
    'region' => 'us-west-2',
    'retries' => [
        'mode' => 'standard',
        'max_attempts' => 7
    ],
]);

In questo esempio viene passata un'istanza di Aws\CacheInterface per memorizzare nella cache i valori restituiti dal provider di configurazione dei nuovi tentativi predefinito.

use Aws\DoctrineCacheAdapter;
use Aws\S3\S3Client;
use Doctrine\Common\Cache\ApcuCache;

$s3 = new S3Client([
    'region' => 'us-west-2',
    'endpoint_discovery' => new DoctrineCacheAdapter(new ApcuCache),
]);

scheme

Schema di URI da usare per la connessione. L'SDK usa endpoint "https" (ovvero, utilizza le connessioni SSL/TLS) per impostazione predefinita. Puoi tentare di connetterti a un servizio su un endpoint "http" non crittografato impostando scheme su "http".

$s3 = new Aws\S3\S3Client([
    'version' => '2006-03-01',
    'region'  => 'us-west-2',
    'scheme'  => 'http'
]);

Consulta le AWSregioni e gli endpoint per un elenco degli endpoint e per sapere se un servizio supporta lo schema. http

service

Nome del servizio da utilizzare. Questo valore viene fornito per impostazione predefinita quando si usa un client fornito dall'SDK (ad esempio, Aws\S3\S3Client). Questa opzione è utile quando si testa un servizio non ancora pubblicato nell'SDK, ma che hai disponibile su disco.

signature_provider

Un callable che accetta un nome di versione della firma (ad esempiov4), un nome di servizio e una AWS regione e restituisce un Aws\Signature\SignatureInterface oggetto o NULL se il provider è in grado di creare un firmatario per i parametri specificati. Questo provider viene utilizzato per creare firmatari utilizzati dal client.

Esistono varie funzioni fornite dall'SDK nella classe Aws\Signature\SignatureProvider che possono essere utilizzati per creare provider di firma personalizzati.

signature_version

Una stringa che rappresenta una versione di firma personalizzata per l'uso con un servizio (ad esempio v4, ecc.). In base alla firma dell'operazione, la versione POTREBBE ignorare questa versione di firma richiesta, se necessario.

Gli esempi seguenti mostrano come configurare un client Amazon S3 per utilizzare la versione 4 della firma:

// Set a preferred signature version
$s3 = new Aws\S3\S3Client([
    'version'           => '2006-03-01',
    'region'            => 'us-west-2',
    'signature_version' => 'v4'
]);

ua_append

Una stringa o matrice di stringhe che vengono aggiunte alla stringa utente-agente passata al gestore HTTP.

use_aws_shared_config_files

Imposta su false per disabilitare il controllo del file di configurazione condiviso in '~/.aws/config' e '~/.aws/credentials'. Ciò sovrascriverà la variabile di ambiente AWS_CONFIG_FILE.

validate

Imposta su false per disabilitare la convalida del parametro lato client. Puoi notare che la disattivazione della convalida può migliorare leggermente le prestazioni del client, ma la differenza è trascurabile.

// Disable client-side validation
$s3 = new Aws\S3\S3Client([
    'version'  => '2006-03-01',
    'region'   => 'eu-west-1',
    'validate' => false
]);

Imposta su un array associativo di opzioni di convalida per abilitare vincoli di convalida specifici:

// Validate only that required values are present
$s3 = new Aws\S3\S3Client([
    'version'  => '2006-03-01',
    'region'   => 'eu-west-1',
    'validate' => ['required' => true]
]);

version

Questa opzione specifica la versione del servizio web da utilizzare (ad esempio,). 2006-03-01

A partire dalla versione 3.277.10 dell'SDK, l'opzione «versione» non è richiesta. Se non specifichi l'opzione «versione», l'SDK utilizza la versione più recente del client di servizio.

Due situazioni richiedono un parametro «versione» quando si crea un client di servizio.

Ad esempio, lo snippet seguente utilizza la versione 3.279.7 dell'SDK, ma non la versione più recente di. Ec2Client

$ec2Client = new \Aws\Ec2\Ec2Client([
    'version' => '2015-10-01',
    'region' => 'us-west-2'
]);

Specificando un vincolo di versione si garantisce che il codice non sarà interessato da un'interruzione delle modifiche apportate al servizio.

Puoi trovare un elenco delle versioni dell'API disponibili nella pagina della documentazione API di ciascun client. Se non riesci a caricare una versione dell'API specifica, potrebbe essere necessario aggiornare la copia dell'SDK.