Transférer des fichiers et des répertoires - AWS SDK pour PHP

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.