Utilisation de base - AWS SDK pour PHP
Création d'un gestionnaire de transferts

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.

Utilisation de base

L'exemple suivant montre comment utiliser le gestionnaire de transfert S3 :

<?php

use Aws\S3\S3Client;
use Aws\S3\S3Transfer\Models\UploadRequest;
use Aws\S3\S3Transfer\S3TransferManager;

require __DIR__ . '/../vendor/autoload.php';


// Create an S3 client.
$s3Client = new S3Client([
    'version' => 'latest',
    'region'  => 'us-west-2',
]);

// Create a transfer manager with default configuration.
$transferManager = new S3TransferManager($s3Client);

// Alternative: Create transfer manager with null client. S3 Transfer Manager uses a default S3 client.
$transferManager = new S3TransferManager(null, [
    'default_region' => 'us-west-2'
]);

// Example: Upload a file.
$uploadPromise = $transferManager->upload(
    new UploadRequest(
        '/path/to/local/file.txt',
        [
            'Bucket' => 'amzn-s3-demo-bucket',
            'Key'    => 'path/to/s3/file.txt',
        ]
    )
);

// Wait for the upload to complete.
$result = $uploadPromise->wait();

echo "Upload complete!\n";
Important

Lors de l'utilisation de S3 Transfer Manager pour créer un client Amazon S3 par défaut, les clients peuvent transmettre une région par défaut au client en utilisant le default_region paramètre des config options du gestionnaire de transfert, sinon le client Amazon S3 essaie de résoudre une région en utilisant le comportement par défaut pour résoudre les configurations, et si la région n'est pas résolue, une exception est déclenchée.

Création d'un gestionnaire de transferts

Vous pouvez créer un gestionnaire de transferts de deux manières :

Avec un client S3 existant

Transmettez une S3Clientinstance existante au S3TransferManager <add link> constructeur.

<?php

use Aws\S3\S3Client;
use Aws\S3\S3Transfer\S3TransferManager;

require __DIR__ . '/../vendor/autoload.php';

// Create an S3 client.
$s3Client = new S3Client([
    'version' => 'latest',
    'region'  => 'us-west-2',
]);

$transferManager = new S3TransferManager($s3Client);
Avec la création d'un client S3 par défaut

Passez null en tant que client et spécifiez les options de configuration.

<?php

use Aws\S3\S3Transfer\S3TransferManager;

require __DIR__ . '/../vendor/autoload.php';

$transferManager = new S3TransferManager(null, [
    'default_region' => 'us-west-2'
]);