翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 基本的な使用法
<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>

Transfer Manager は、次の 2 つの方法で作成できます。

既存の 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` *<add link>* コンストラクタに渡します。  

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