Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Administrador de transferencias de Amazon S3 con la versió 3 de AWS SDK for PHP

El administrador de transferencias de Amazon S3 en el AWS SDK for PHP se utiliza para cargar directorios completos en un bucket de Amazon S3 y descargar buckets completos en un directorio local.

Cargar un directorio local en Amazon S3

El objeto Aws\S3\Transfer se utiliza para realizar transferencias. En el siguiente ejemplo se muestra cómo cargar de forma recursiva un directorio local de archivos a un bucket de 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();

En este ejemplo, hemos creado un cliente de Amazon S3 y un objeto Transfer, y hemos realizado la transferencia de forma síncrona. En el ejemplo anterior se muestra la cantidad de código mínimo necesaria para realizar una transferencia. El objeto Transfer puede realizar las transferencias de forma asíncrona y dispone de varias opciones de configuración que puede utilizar para personalizar las transferencias.

Puede cargar los archivos locales a una «subcarpeta» de un bucket de Amazon S3 añadiendo un prefijo de clave al URI de s3://. En el siguiente ejemplo se cargan los archivos locales en el disco en el bucket bucket y se almacenan los archivos con el prefijo de clave foo.

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

Descargar un bucket de Amazon S3

Puede descargar de forma recursiva un bucket de Amazon S3 en un directorio local del disco especificando el argumento $source como URI de Amazon S3 (por ejemplo, s3://bucket) y el argumento $dest como la ruta a un directorio local.

// 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();

Puede incluir un prefijo de clave en el URI de Amazon S3 después del bucket para descargar solo los objetos almacenados en una «pseudocarpeta». En el siguiente ejemplo, solo se descargan los archivos almacenados con el prefijo de clave "/foo" del bucket determinado.

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

Configuración

El constructor del objeto Transfer acepta los siguientes argumentos.

Transferencias asíncronas

El objeto Transfer es una instancia de GuzzleHttp\Promise\PromisorInterface. Esto significa que la transferencia puede producirse de forma asíncrona y que se inicia llamando al método promise del objeto.

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

La promesa se rechazará si alguno de los archivos no se puede transferir. Puede administrar la transferencia fallida de forma asíncrona utilizando el método otherwise de la promesa. La función otherwise acepta una devolución de llamada cuando se produce un error. La devolución de llamada acepta el $reason para el rechazo, que por lo general será una instancia de Aws\Exception\AwsException (aunque se puede enviar cualquier tipo de valor a la devolución de llamada).

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

Dado que el objeto Transfer devuelve una promesa, estas transferencias pueden producirse de forma simultánea con otras promesas asíncronas.

Personalizar los comandos del administrador de transferencias

Puede establecer opciones personalizadas en las operaciones ejecutadas por el administrador de transferencias mediante una devolución de llamada transferida a su constructor.

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