本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置
S3 传输管理器接受配置选项以自定义其行为。在创建转移管理器的实例时,请提供这些选项。配置参数可以是数组,也可以是的实例S3TransferManagerConfig<add link>。
以下示例配置 S3 传输管理器实例:
<?php use Aws\S3\S3Transfer\S3TransferManager; require __DIR__ . '/../vendor/autoload.php'; $transferManager = new S3TransferManager( null, [ // 10MB parts for multipart operations. 'target_part_size_bytes' => 10 * 1024 * 1024, // Use multipart upload for files larger than 20MB. 'multipart_upload_threshold_bytes' => 20 * 1024 * 1024, // Enable checksum calculation for data integrity. 'request_checksum_calculation' => 'when_supported', // Enable checksum validation when getting objects. 'response_checksum_validation' => 'when_supported', // Use part-based multipart downloads. 'multipart_download_type' => 'part', // Allow up to 10 concurrent operations. 'concurrency' => 10, // Enable progress tracking. 'track_progress' => true, // Set default region for default S3 client construction. 'default_region' => 'us-west-2', ] );
注意
当您将配置作为数组提供给时S3TransferManager,SDK 会在内部调用S3TransferManagerConfig::fromArray以将其转换为正确的类型。
配置选项
所有配置选项都是可选的,如果未指定,则使用默认值。
| Option | Type | 默认值 | 说明 |
|---|---|---|---|
|
|
int |
8MB |
分段上传/下载的最小分段大小。 |
|
|
int |
16 MB |
使用分段上传的文件大小阈值。 |
|
|
字符串 |
'when_supported' |
启用校验和计算。有效值为 “支持时”、“需要时”。 |
|
|
字符串 |
'when_supported' |
在获取对象时启用校验和验证。有效值为 “支持时”、“需要时”。 |
|
|
字符串 |
'部分' |
下载大文件策略。有效值为 “部分”(分段下载)、“范围”(范围请求)。 |
|
|
int |
5 |
并发操作的最大数量。 |
|
|
布尔 |
FALSE |
是否跟踪传输进度。 |
|
|
字符串 |
'us-east-1' |
AWS 区域 如果未提供 S3 客户端,则使用。 |