Configuration - 適用於 PHP 的 AWS SDK

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Configuration

S3 Transfer Manager 接受組態選項來自訂其行為。當您建立 Transfer Manager 執行個體時,請提供這些選項。組態參數可以是陣列或 S3TransferManagerConfig <add link> 的執行個體。

下列範例會設定 S3 Transfer Manager 執行個體:

<?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,軟體開發套件會在內部呼叫 S3TransferManagerConfig::fromArray ,將其轉換為適當的類型。

組態選項

所有組態選項皆為選用,未指定時使用預設值。

選項 Type 預設 Description

target_part_size_bytes

int

8MB

分段上傳/下載的最小部分大小。

multipart_upload_threshold_bytes

int

16MB

使用分段上傳的檔案大小閾值。

request_checksum_calculation

string

'when_supported'

啟用檢查總和計算。有效值為 'when_supported'、'when_required'。

response_checksum_validation

string

'when_supported'

取得物件時啟用檢查總和驗證。有效值為 'when_supported'、'when_required'。

multipart_download_type

string

「部分」

大型檔案的下載策略。有效值為 'part' (分段下載)、'ranged' (範圍請求)。

concurrency

int

5

並行操作的數量上限。

track_progress

bool

FALSE

是否追蹤傳輸進度。

default_region

string

'us-east-1'

AWS 區域 如果未提供 S3 用戶端,則使用 。