기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS SDK for PHP 버전 3을 사용한 Amazon S3 전송 관리자

AWS SDK for PHP의 Amazon S3 전송 관리자는 전체 디렉터리를 Amazon S3 버킷에 업로드하고 전체 버킷을 로컬 디렉터리에 다운로드하는 데 사용됩니다.

Amazon S3에 로컬 디렉터리 업로드

Aws\S3\Transfer 객체는 전송을 수행하는 데 사용됩니다. 다음 예에서는 파일의 로컬 디렉터리를 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();

이 예에서는 Amazon S3 클라이언트와 Transfer 객체를 생성하고 전송을 동기적으로 수행했습니다. 이전 예제를 사용하여 전송을 수행하는 데 필요한 최소한의 코드를 보여줍니다. 전송 객체는 전송을 비동기적으로 수행할 수 있으며 전송을 사용자 지정하는 데 사용할 수 있는 다양한 구성 옵션이 있습니다.

s3:// URI에 키 접두사를 제공하여 Amazon S3 버킷의 "하위 폴더"에 로컬 파일을 업로드할 수 있습니다. 다음 예에서는 디스크에 있는 로컬 파일을 bucket 버킷에 업로드하고 foo 키 접두사 아래에 파일을 저장합니다.

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

Amazon S3 버킷 다운로드

$source 인수를 Amazon S3 URI(예: s3://bucket)로 지정하고, $dest 인수를 로컬 디렉터리에 대한 경로로 지정하여 디스크에 있는 로컬 디렉터리에 Amazon S3 버킷을 재귀적으로 다운로드할 수 있습니다.

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

"가상 폴더" 아래에 저장된 객체만 다운로드하려면 Amazon S3 URI에서 버킷 뒤에 키 접두사를 포함할 수 있습니다. 다음 예에서는 지정된 버킷의 "/foo" 키 접두사 아래에 저장된 파일만 다운로드합니다.

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

구성

Transfer 객체 생성자는 다음 인수를 받습니다.

비동기적 전송

Transfer 객체가 GuzzleHttp\Promise\PromisorInterface의 인스턴스입니다. 즉, 객체의 promise 메서드를 호출하여 전송을 비동기적으로 수행하고 시작할 수 있습니다.

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

전송되지 않은 파일이 있을 경우 promise가 거부됩니다. promise의 otherwise 메서드를 사용하여 실패한 전송을 비동기적으로 처리할 수 있습니다. otherwise 함수는 오류 발생 시 호출할 콜백을 받습니다. 콜백은 거부에 대한 $reason(일반적으로 Aws\Exception\AwsException의 인스턴스)을 받습니다. 하지만 모든 유형의 값을 콜백에 제공할 수 있습니다.

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

Transfer 객체는 promise를 반환하므로 이러한 전송이 다른 비동기적 promise와 동시에 발생할 수 있습니다.

전송 관리자의 명령 사용자 지정

생성기에 전달된 콜백을 통해 전송 관리자에서 실행되는 작업에 대해 사용자 지정 옵션을 설정할 수 있습니다.

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