本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 |
|---|---|---|---|
|
|
int |
8MB |
分段上傳/下載的最小部分大小。 |
|
|
int |
16MB |
使用分段上傳的檔案大小閾值。 |
|
|
string |
'when_supported' |
啟用檢查總和計算。有效值為 'when_supported'、'when_required'。 |
|
|
string |
'when_supported' |
取得物件時啟用檢查總和驗證。有效值為 'when_supported'、'when_required'。 |
|
|
string |
「部分」 |
大型檔案的下載策略。有效值為 'part' (分段下載)、'ranged' (範圍請求)。 |
|
|
int |
5 |
並行操作的數量上限。 |
|
|
bool |
FALSE |
是否追蹤傳輸進度。 |
|
|
string |
'us-east-1' |
AWS 區域 如果未提供 S3 用戶端,則使用 。 |