As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Transferir arquivos e diretórios
A AWS SDK for PHP versão 3 fornece duas abordagens para transferir arquivos e diretórios de e para o Amazon S3. Ambas as soluções lidam com a complexidade de uploads e downloads de várias partes para arquivos grandes, mas diferem em sua filosofia de design, conjunto de recursos e padrões de uso.
Visão geral das opções de transferência
Escolha a abordagem de transferência que melhor atenda às necessidades do seu aplicativo:
- S3 Transfer Manager (recomendado)
-
Uma biblioteca moderna e de alto nível que fornece uma solução abrangente para transferências de arquivos. Ele oferece amplas opções de configuração, rastreamento de progresso integrado, manipuladores de download personalizados e tratamento robusto de erros. O S3 Transfer Manager usa uma API baseada em promessas e oferece suporte a operações individuais de arquivos e transferências de diretórios com recursos avançados de filtragem.
- Transferência
-
Uma implementação de transferência de diretórios que se concentra especificamente em operações de diretórios em massa. Ele fornece uma API mais simples para carregar e baixar diretórios inteiros com opções básicas de configuração. Essa abordagem tem menos recursos em comparação com o S3 Transfer Manager.
Principais diferenças
A tabela a seguir destaca as principais diferenças entre as duas abordagens de transferência:
| Recurso | Gerenciador de transferências do S3 | Transferir |
|---|---|---|
Operações de arquivo individuais |
Sim (carregar/baixar arquivos individuais) |
Não (somente operações de diretório) |
Operações de diretório |
Sim (com filtragem avançada) |
Sim (transferências básicas de diretórios) |
Acompanhamento do progresso |
Integrado com ouvintes personalizados |
Limitado (somente saída de depuração) |
Manipuladores de download personalizados |
Sim |
Não |
Validação da soma de verificação |
Automático com configuração |
Manual (opção add_content_md5) |
Tratamento de erros |
Abrangente com políticas de falha |
Tratamento básico baseado em promessas |
Opções de configuração |
Extenso (mais de 8 opções) |
Básico (6 opções) |
Design de API |
Objetos de solicitação/resposta |
Parâmetros simples do construtor |
Como escolher a abordagem correta
Use o S3 Transfer Manager quando precisar:
Operações individuais de upload ou download de arquivos
Rastreamento e monitoramento avançados do progresso
Manipuladores de download personalizados para processamento especializado
Políticas abrangentes de tratamento de erros e novas tentativas
Controle refinado sobre operações com várias partes
Operações de diretório com lógica de filtragem complexa
Use Transfer quando precisar:
Transferências simples de diretório de/para o S3
Configuração e configuração mínimas
Compatibilidade com o código existente que usa Transfer
Funcionalidade básica de carregamento em várias partes
nota
Para novos aplicativos, recomendamos o uso do S3 Transfer Manager, pois ele fornece uma solução mais abrangente e flexível para transferências de arquivos.
