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

Transfer direktori ke dan dari Amazon S3 menggunakan AWS SDK untuk PHP Versi 3

Anda menggunakan Transfer kelas di AWS SDK untuk PHP Versi 3 untuk mengunggah seluruh direktori ke bucket Amazon S3 dan mengunduh seluruh bucket ke direktori lokal.

Mengunggah direktori lokal ke Amazon S3

Aws\S3\TransferObjek 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.
$directoryTransfer = new \Aws\S3\Transfer($client, $source, $dest);

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

Dalam contoh ini, kami membuat klien Amazon S3, membuat Transfer objek, dan melakukan transfer secara sinkron.

Contoh sebelumnya menunjukkan jumlah minimum kode yang diperlukan untuk melakukan transfer. Sebuah Transfer objek juga 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';
$directoryTransfer = new \Aws\S3\Transfer($client, $source, $dest);
$directoryTransfer->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';

$directoryTransfer = new \Aws\S3\Transfer($client, $source, $dest);
$directoryTransfer->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';
$directoryTransfer = new \Aws\S3\Transfer($client, $source, $dest);
$directoryTransfer->transfer();

Konfigurasi

Konstruktor Transfer objek menerima argumen berikut.

Transfer async

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';
$directoryTransfer = new \Aws\S3\Transfer($client, $source, $dest);

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

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

Janji ditolak jika ada file yang 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 merupakan instance dari 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 transfer direktori

Dengan menambahkan callback ke konstruktor, Anda dapat menyesuaikan opsi yang dijalankan. Transfer

$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';
        }
    },
]);