Migração Drupal 7 para Drupal 10: O Guia Definitivo para 2025
Passo a passo completo — da auditoria ao go-live — para migrar sem downtime e sem perder conteúdo
Por que migrar é urgente
O Drupal 7 chegou ao fim de vida oficial em 5 de janeiro de 2025. Isso significa:
- Sem mais patches de segurança da comunidade
- Vulnerabilidades acumulando sem correção
- Módulos contribuídos parando de receber suporte
- Risco crescente de compliance (LGPD, PCI-DSS, HIPAA)
Se o seu site ainda roda Drupal 7, a migração não é opcional — é questão de quando e como, não se.
O que mudou do D7 para o D10
O Drupal 10 é fundamentalmente diferente do D7. Principais mudanças:
| Aspecto | Drupal 7 | Drupal 10 | |---------|----------|-----------| | PHP mínimo | 5.6 | 8.1+ | | Banco de dados | MySQL 5.1 | MySQL 8.0 / PostgreSQL 14 | | Template engine | PHPTemplate | Twig 3 | | Frontend | jQuery/Overlay | Vanilla JS / Decoupled | | API | Custom hooks | Symfony/PSR | | Config | Database | YAML files |
O processo em 6 fases
Fase 1: Auditoria (2-4 semanas)
- Inventário de todos os módulos contribuídos
- Verificar equivalentes no D10 ou necessidade de reescrita
- Auditoria de conteúdo: o que migrar, o que arquivar
- Análise de customizações no tema
Fase 2: Ambiente paralelo (1 semana)
Nunca migre em produção. Configure um ambiente D10 completo em paralelo.
Fase 3: Migração de conteúdo (2-6 semanas)
O módulo migrate do D10 lê diretamente o banco D7. Configure mapeamentos de campo e execute:
drush migrate:import --all
drush migrate:status
Fase 4: Reconstrução do tema (4-8 semanas)
Temas D7 não são compatíveis com D10. Opções:
- Reescrever o tema existente em Twig (recomendado para preservar identidade visual)
- Adotar tema base (Olivero ou Claro) e customizar
- Headless/decoupled com Next.js consumindo a Drupal JSON:API
Fase 5: Validação e SEO
Antes do go-live:
- Auditar URLs e configurar redirects 301
- Verificar sitemap.xml
- Testar todos os formulários
- Validar Lighthouse score (meta: >90 em Performance e SEO)
Fase 6: Go-live e monitoramento
Migração DNS, monitoramento de erros 404, acompanhamento de Search Console.
Quanto tempo leva?
Para um site típico de empresa (50-500 nós, 5-15 content types):
- Projeto simples: 2-3 meses
- Projeto médio: 4-6 meses
- Portal complexo: 8-12 meses
A Solidum Tecnologia já migrou mais de 15 sites Drupal 7 para versões atuais. Fale com a nossa equipe →