Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Transférer des fichiers et des répertoires
La AWS SDK pour PHP version 3 propose deux approches pour le transfert de fichiers et de répertoires vers et depuis Amazon S3. Les deux solutions gèrent la complexité des chargements et téléchargements partitionnés pour des fichiers volumineux, mais elles diffèrent en termes de philosophie de conception, de fonctionnalités et de modèles d'utilisation.
Vue d'ensemble des options de transfert
Choisissez l'approche de transfert la mieux adaptée aux besoins de votre application :
- Gestionnaire de transfert S3 (recommandé)
-
Une bibliothèque moderne de haut niveau qui fournit une solution complète pour les transferts de fichiers. Il offre de nombreuses options de configuration, un suivi intégré de la progression, des gestionnaires de téléchargement personnalisés et une gestion robuste des erreurs. Le S3 Transfer Manager utilise une API basée sur les promesses et prend en charge à la fois les opérations de fichiers individuels et les transferts de répertoires grâce à des fonctionnalités de filtrage avancées.
- Transfert
-
Une implémentation de transfert d'annuaire qui se concentre spécifiquement sur les opérations d'annuaire en masse. Il fournit une API plus simple pour le chargement et le téléchargement de répertoires entiers avec des options de configuration de base. Cette approche comporte moins de fonctionnalités que le gestionnaire de transfert S3.
Principales différences
Le tableau suivant met en évidence les principales différences entre les deux approches de transfert :
| Fonctionnalité | Gestionnaire de transfert S3 | Transférer |
|---|---|---|
Opérations sur des fichiers individuels |
Oui (télécharger/télécharger des fichiers uniques) |
Non (opérations d'annuaire uniquement) |
Opérations du répertoire |
Oui (avec filtrage avancé) |
Oui (transferts de répertoire de base) |
Suivi des progrès |
Intégré avec des écouteurs personnalisés |
Limité (sortie de débogage uniquement) |
Gestionnaires de téléchargement personnalisés |
Oui |
Non |
Validation du checksum |
Automatique avec configuration |
Manuel (option add_content_md5) |
Gestion des erreurs |
Complet avec politiques de défaillance |
Gestion de base basée sur les promesses |
Options de configuration |
Vaste (plus de 8 options) |
Basique (6 options) |
Conception d'API |
Objets de demande/réponse |
Paramètres de constructeur simples |
Choix de la bonne approche
Utilisez le gestionnaire de transfert S3 lorsque vous avez besoin de :
Opérations de chargement ou de téléchargement de fichiers individuels
Suivi et surveillance avancés des progrès
Gestionnaires de téléchargement personnalisés pour un traitement spécialisé
Politiques complètes de gestion des erreurs et de nouvelles tentatives
Contrôle précis des opérations en plusieurs parties
Opérations d'annuaire avec logique de filtrage complexe
Utilisez Transfer lorsque vous avez besoin de :
Transferts simples de répertoire vers/depuis-S3
Configuration et installation minimales
Compatibilité avec le code existant qui utilise Transfer
Fonctionnalité de base de téléchargement partitionné
Note
Pour les nouvelles applications, nous recommandons d'utiliser le gestionnaire de transfert S3, car il fournit une solution plus complète et plus flexible pour les transferts de fichiers.