翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ファイルとディレクトリを転送する
AWS SDK for PHP バージョン 3 には、Amazon S3 との間でファイルとディレクトリを転送する 2 つのアプローチがあります。どちらのソリューションも、大きなファイルのマルチパートアップロードとダウンロードの複雑さを処理しますが、設計哲学、機能セット、使用パターンは異なります。
転送オプションの概要
アプリケーションのニーズに最適な転送アプローチを選択します。
- S3 Transfer Manager (推奨)
-
ファイル転送のための包括的なソリューションを提供する最新の高レベルライブラリ。広範な設定オプション、組み込みの進行状況追跡、カスタムダウンロードハンドラー、堅牢なエラー処理を提供します。S3 Transfer Manager は promise ベースの API を使用し、個々のファイルオペレーションと高度なフィルタリング機能を備えたディレクトリ転送の両方をサポートします。
- 転送
-
特に一括ディレクトリオペレーションに焦点を当てたディレクトリ転送実装。基本的な設定オプションを使用してディレクトリ全体をアップロードおよびダウンロードするためのシンプルな API を提供します。このアプローチでは、S3 Transfer Manager と比較して機能が少なくなります。
主な違い
次の表は、2 つの転送アプローチの主な違いを示しています。
| 機能 | S3 Transfer Manager | Transfer |
|---|---|---|
個々のファイルオペレーション |
はい (単一のファイルをアップロード/ダウンロード) |
いいえ (ディレクトリオペレーションのみ) |
ディレクトリオペレーション |
はい (高度なフィルタリングを使用) |
はい (基本的なディレクトリ転送) |
進行状況の追跡 |
カスタムリスナーによる組み込み |
制限あり (デバッグ出力のみ) |
カスタムダウンロードハンドラー |
あり |
なし |
チェックサムの検証 |
設定による自動 |
手動 (add_content_md5 オプション) |
エラー処理 |
包括的な障害ポリシー |
基本的な promise ベースの処理 |
設定オプション |
広範な (8 つ以上のオプション) |
基本 (6 つのオプション) |
API 設計 |
リクエスト/レスポンスオブジェクト |
シンプルなコンストラクタパラメータ |
適切なアプローチの選択
必要に応じて S3 Transfer Manager を使用します。
個々のファイルのアップロードまたはダウンロードオペレーション
高度な進行状況の追跡とモニタリング
特殊な処理のためのカスタムダウンロードハンドラー
包括的なエラー処理と再試行ポリシー
マルチパートオペレーションをきめ細かく制御
複雑なフィルタリングロジックによるディレクトリオペレーション
必要に応じて Transfer を使用します。
S3 への/S3 からのシンプルなディレクトリ転送
最小限の設定とセットアップ
Transfer を使用する既存のコードとの互換性
基本的なマルチパートアップロード機能
注記
新しいアプリケーションでは、S3 Transfer Manager を使用することをお勧めします。S3 Transfer Manager は、ファイル転送のより包括的で柔軟なソリューションを提供します。
