配置 - 适用于 PHP 的 AWS SDK

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

配置

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 默认值 说明

target_part_size_bytes

int

8MB

分段上传/下载的最小分段大小。

multipart_upload_threshold_bytes

int

16 MB

使用分段上传的文件大小阈值。

request_checksum_calculation

字符串

'when_supported'

启用校验和计算。有效值为 “支持时”、“需要时”。

response_checksum_validation

字符串

'when_supported'

在获取对象时启用校验和验证。有效值为 “支持时”、“需要时”。

multipart_download_type

字符串

'部分'

下载大文件策略。有效值为 “部分”(分段下载)、“范围”(范围请求)。

concurrency

int

5

并发操作的最大数量。

track_progress

布尔

FALSE

是否跟踪传输进度。

default_region

字符串

'us-east-1'

AWS 区域 如果未提供 S3 客户端,则使用。