本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
傳輸檔案和目錄
第 3 適用於 PHP 的 AWS SDK 版提供兩種在 Amazon S3 之間傳輸檔案和目錄的方法。這兩種解決方案都處理大型檔案分段上傳和下載的複雜性,但它們的設計理念、功能集和用量模式有所不同。
轉接選項概觀
選擇最適合您應用程式需求的傳輸方法:
- S3 Transfer Manager (建議)
-
現代化的高階程式庫,提供全方位的檔案傳輸解決方案。它提供廣泛的組態選項、內建進度追蹤、自訂下載處理常式,以及強大的錯誤處理。S3 Transfer Manager 使用以承諾為基礎的 API,並支援個別檔案操作和具有進階篩選功能的目錄傳輸。
- 傳輸
-
特別著重於大量目錄操作的目錄傳輸實作。它提供更簡單的 API,以使用基本組態選項上傳和下載整個目錄。相較於 S3 Transfer Manager,此方法的功能較少。
主要差異
下表重點介紹兩種傳輸方法之間的主要差異:
| 功能 | S3 Transfer Manager | 轉移 |
|---|---|---|
個別檔案操作 |
是 (上傳/下載單一檔案) |
否 (僅限目錄操作) |
目錄操作 |
是 (使用進階篩選) |
是 (基本目錄傳輸) |
進度追蹤 |
內建自訂接聽程式 |
有限 (僅限偵錯輸出) |
自訂下載處理常式 |
是 |
否 |
檢查總和驗證 |
使用組態自動執行 |
手動 (add_content_md5 選項) |
錯誤處理 |
綜合故障政策 |
基本以承諾為基礎的處理 |
組態選項 |
廣泛 (8 個以上選項) |
基本 (6 個選項) |
API 設計 |
請求/回應物件 |
簡單建構函數參數 |
選擇正確的方法
需要時使用 S3 Transfer Manager:
個別檔案上傳或下載操作
進階進度追蹤和監控
用於特殊處理的自訂下載處理常式
全面的錯誤處理和重試政策
精細控制分段操作
具有複雜篩選邏輯的目錄操作
當您需要時使用 Transfer:
簡單的目錄到/從 S3 傳輸
最低組態和設定
與使用 Transfer 的現有程式碼的相容性
基本分段上傳功能
注意
對於新應用程式,我們建議您使用 S3 Transfer Manager,因為它為檔案傳輸提供更全面且靈活的解決方案。