Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Manajer transfer Amazon S3 dengan AWS SDK for PHP Versi 3

Manajer transfer Amazon S3 di dalamnya AWS SDK for PHP digunakan untuk mengunggah seluruh direktori ke bucket Amazon S3 dan mengunduh seluruh bucket ke direktori lokal.

Mengunggah direktori lokal ke Amazon S3

Aws\S3\TransferObjek digunakan untuk melakukan transfer. Contoh berikut menunjukkan cara mengunggah direktori file lokal secara rekursif ke bucket Amazon S3.

// Create an S3 client.
$client = new \Aws\S3\S3Client([
    'region'  => 'us-west-2',
    'version' => '2006-03-01',
]);

// Where the files will be sourced from.
$source = '/path/to/source/files';

// Where the files will be transferred to.
$dest = 's3://bucket';

// Create a transfer object.
$manager = new \Aws\S3\Transfer($client, $source, $dest);

// Perform the transfer synchronously.
$manager->transfer();

Dalam contoh ini, kami membuat klien Amazon S3, membuat Transfer objek, dan melakukan transfer secara sinkron. Menggunakan contoh sebelumnya menunjukkan jumlah minimum kode yang diperlukan untuk melakukan transfer. Objek transfer dapat melakukan transfer secara asinkron dan memiliki berbagai opsi konfigurasi yang dapat Anda gunakan untuk menyesuaikan transfer.

Anda dapat mengunggah file lokal ke “subfolder” bucket Amazon S3 dengan menyediakan key prefix di URI. s3:// Contoh berikut mengunggah file lokal pada disk ke bucket bucket dan menyimpan file di bawah foo key prefix.

$source = '/path/to/source/files';
$dest = 's3://bucket/foo';
$manager = new \Aws\S3\Transfer($client, $source, $dest);
$manager->transfer();

Mengunduh bucket Amazon S3

Anda dapat mengunduh bucket Amazon S3 secara rekursif ke direktori lokal pada disk dengan menentukan $source argumen sebagai URI Amazon S3 (mis.s3://bucket,) dan argumen sebagai jalur $dest ke direktori lokal.

// Where the files will be sourced from.
$source = 's3://bucket';

// Where the files will be transferred to.
$dest = '/path/to/destination/dir';

$manager = new \Aws\S3\Transfer($client, $source, $dest);
$manager->transfer();

Anda dapat menyertakan key prefix di Amazon S3 URI setelah bucket hanya mengunduh objek yang disimpan di bawah “pseudo-folder”. Contoh berikut hanya mengunduh file yang disimpan di bawah awalan kunci “/foo” dari bucket yang diberikan.

$source = 's3://bucket/foo';
$dest = '/path/to/destination/dir';
$manager = new \Aws\S3\Transfer($client, $source, $dest);
$manager->transfer();

Konfigurasi

Konstruktor Transfer objek menerima argumen berikut.

Transfer asinkron

TransferObjek adalah contoh dariGuzzleHttp\Promise\PromisorInterface. Ini berarti bahwa transfer dapat terjadi secara asinkron dan dimulai dengan memanggil promise metode objek.

$source = '/path/to/source/files';
$dest = 's3://bucket';
$manager = new \Aws\S3\Transfer($client, $source, $dest);

// Initiate the transfer and get a promise.
$promise = $manager->promise();

// Do something when the transfer is complete using the then() method.
$promise->then(function () {
    echo 'Done!';
});

Janji akan ditolak jika salah satu file gagal ditransfer. Anda dapat menangani transfer yang gagal secara asinkron menggunakan otherwise metode janji. otherwiseFungsi menerima callback untuk memanggil ketika terjadi kesalahan. Callback menerima penolakan, yang biasanya berupa instance Aws\Exception\AwsException (meskipun nilai jenis apa pun dapat dikirimkan ke callback). $reason

$promise->otherwise(function ($reason) {
    echo 'Transfer failed: ';
    var_dump($reason);
});

Karena Transfer objek mengembalikan janji, transfer ini dapat terjadi bersamaan dengan janji asinkron lainnya.

Menyesuaikan perintah manajer transfer

Opsi khusus dapat diatur pada operasi yang dijalankan oleh manajer transfer melalui panggilan balik yang diteruskan ke konstruktornya.

$uploader = new Transfer($s3Client, $source, $dest, [
    'before' => function (\Aws\Command $command) {
        // Commands can vary for multipart uploads, so check which command
        // is being processed.
        if (in_array($command->getName(), ['PutObject', 'CreateMultipartUpload'])) {
            // Set custom cache-control metadata.
            $command['CacheControl'] = 'max-age=3600';
            // Apply a canned ACL.
            $command['ACL'] = strpos($command['Key'], 'CONFIDENTIAL') ### false
                ? 'public-read'
                : 'private';
        }
    },
]);