Amazon S3 para TYPO3

aus_driver_amazon_s3 é a solução padrão quando assets TYPO3 não podem mais ficar no webserver, a extensão traz buckets S3 como driver FAL completo ao stack TYPO3

Um setup TYPO3 clássico armazena todos os dados de mídia em fileadmin, no webserver. Isso funciona enquanto o projeto roda em uma única máquina e o armazenamento basta. Assim que, porém, entram em cena setups multi-server, container clusters, auto scaling ou Content Delivery Networks, esse modelo quebra. Cada instância precisaria de uma cópia idêntica de todos os arquivos, sincronização vira obra permanente, deploys ficam lentos. O aus_driver_amazon_s3 resolve isso integrando o Amazon S3 como storage FAL externo. Arquivos ficam no bucket, o TYPO3 lê e grava via API S3, e cada instância de servidor acessa a mesma base consistente. Para projetos com exigência de alta disponibilidade, esse é o caminho padrão.

Além da necessidade técnica para setups multi-server, existe um segundo driver importante: backup e redundância. O S3 armazena cada arquivo automaticamente de forma múltipla entre data centers, atingindo uma retenção que um webserver clássico não garante. Para empresas cujos dados de mídia são críticos para o negócio, isso por si só é motivo para migrar ao S3.

Cenários típicos de uso

O primeiro caso são deploys cloud native em AWS, Kubernetes ou Docker Swarm. O TYPO3 roda em vários containers atrás de um Load Balancer, cada container é stateless. Fileadmin como diretório local significaria que uploads só pousam em um container e os outros não os veem. O aus_driver_amazon_s3 mantém o acervo de assets central e torna scale out praticável.

O segundo caso são projetos com volumes muito grandes de dados. Uma plataforma de mídia, um arquivo de imagens ou um portal de download cresce rapidamente para várias centenas de gigabytes ou terabytes. Armazenamento local no servidor fica caro e inflexível, o S3 escala de forma transparente e cobra apenas o que está realmente ocupado. A conexão via FAL permite mudar para o novo storage sem alterações de código no TYPO3.

Terceiro uso: integração CDN. Quem quer entregar imagens e downloads via Cloudfront, Cloudflare ou CDN próprio usa S3 como origin. O aus_driver_amazon_s3 disponibiliza os arquivos diretamente no bucket, o TYPO3 gera os URLs corretos e o CDN os cacheia globalmente. Isso melhora mensuravelmente o tempo de carregamento para visitantes internacionais.

Arquitetura técnica

O aus_driver_amazon_s3 implementa a interface FAL Driver do TYPO3 e usa o AWS SDK for PHP oficial para comunicação com o S3. Cada bucket é configurado como um File Storage próprio no backend TYPO3, com indicação de nome do bucket, região, Access Key e Secret Key. Alternativamente, IAM roles podem ser usadas quando o TYPO3 roda em uma instância EC2 ou em uma task ECS, o que é mais limpo, porque não há credenciais estáticas na configuração.

A extensão suporta tanto o Amazon S3 quanto serviços compatíveis com S3 como MinIO, Backblaze B2, DigitalOcean Spaces ou Scaleway Object Storage. Para projetos que, por razões de proteção de dados, não podem usar AWS, essa flexibilidade é importante, um provedor compatível com S3 no Brasil ou na Europa se comporta, do ponto de vista do TYPO3, exatamente como o serviço AWS.

Em operação, o TYPO3 lê e escreve direto contra o S3. Os processed files, ou seja, as variantes de imagem cortadas e otimizadas, são por padrão também salvas no bucket. Alternativamente, um diretório local para processed files pode ser configurado, o que acelera o processamento de imagem, porque o GIFBUILDER não precisa puxar cada imagem original do S3.

A configuração é feita via o módulo backend “File Storages” e configurações TypoScript complementares para a URL do bucket e prefixos CDN. Desenvolvedores precisam, adicionalmente, instalar a dependência AWS SDK via Composer e definir as permissões corretas no bucket.

Problemas frequentes e soluções

O primeiro problema é performance em listas grandes de imagens. Quando uma página precisa cortar dezenas de imagens ao mesmo tempo e os arquivos fonte são puxados do S3, a construção da página demora perceptivelmente mais. A solução está em um cache local para processed files, eventualmente combinado com um script de pré-warming que, após novos uploads, gera antecipadamente as variantes mais comuns.

Segundo problema: erros de permissão no upload. Quando o TYPO3 quer gravar no bucket mas a policy IAM só permite leitura, o upload quebra com mensagem de erro enigmática. A solução é uma policy precisa com s3:GetObject, s3:PutObject, s3:DeleteObject e s3:ListBucket exatamente para o bucket do TYPO3, idealmente limitada a um prefix, para que outras aplicações no mesmo bucket não sejam afetadas por acidente.

Terceiro problema: proteção de dados e escolha de região. Projetos que precisam operar em conformidade com a LGPD (PT: RGPD) devem escolher regiões AWS na América do Sul, tipicamente sa-east-1 em São Paulo, ou considerar um provedor brasileiro compatível com S3. Para exigências mais altas ou clientes que excluem a AWS em princípio, um provedor nacional compatível é o caminho adequado. A extensão trabalha com todos esses provedores.

Migração e compatibilidade de versões

O aus_driver_amazon_s3 é compatível com TYPO3 v11, v12 e v13 e é desenvolvido ativamente. Em upgrades, vale atenção à versão do AWS SDK, versões mais novas do TYPO3 frequentemente exigem versões atuais do SDK, que por sua vez exigem PHP 8.1 ou superior.

Uma migração de fileadmin local para S3 é um projeto claramente delimitado: copiar os arquivos inicialmente via aws s3 sync para o bucket, configurar um novo File Storage no backend TYPO3, redirecionar os registros sys_file existentes para o novo storage via script, apagar os arquivos locais após teste bem-sucedido. A extensão não traz uma rotina de migração pronta, porque o modo exato é específico de cada projeto.

No acervo, antes da migração, vale a obrigação do inventário. Quantos arquivos estão no fileadmin, qual o tamanho do acervo, quais estão órfãos e quais ainda estão realmente linkados? Em auditorias assim, frequentemente se descobre que boa parte dos dados antigos nunca mais é chamada e a migração pode se restringir aos arquivos ativamente usados. Isso reduz risco, esforço e custos de bucket.

A Gosign acompanha migrações S3 para projetos TYPO3 e desenha arquiteturas multi cloud que atendem simultaneamente exigências de proteção de dados e metas de performance.