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

# 기본 사용법
<a name="basic-usage"></a>

다음 예제에서는 S3 Transfer Manager를 사용하는 방법을 보여줍니다.

```
<?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";
```

**중요**  
S3 Transfer Manager를 사용하여 기본 Amazon S3 클라이언트를 생성하는 경우 고객은 Transfer Manager `config` 옵션의 `default_region` 파라미터를 사용하여 클라이언트의 기본 리전을 전달할 수 있습니다. 그렇지 않으면 Amazon S3 클라이언트는 구성 해결을 위한 기본 동작을 사용하여 리전을 확인하려고 시도하고 리전이 확인되지 않으면 예외가 발생합니다.

## 전송 관리자 생성
<a name="creating-transfer-manager"></a>

다음 두 가지 방법으로 전송 관리자를 생성할 수 있습니다.

기존 S3 클라이언트 사용  
기존 [https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.S3.S3Client.html](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.S3.S3Client.html) 인스턴스를 `S3TransferManager` *<링크 추가>* 생성자에 전달합니다.  

```
<?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);
```

기본 S3 클라이언트 생성 사용  
클라이언트`null`로 전달하고 구성 옵션을 지정합니다.  

```
<?php

use Aws\S3\S3Transfer\S3TransferManager;

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

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