Como Usar o All-in-One WP Migration no WordPress: Guia Técnico Completo

All-in-One WP Migration é um plugin WordPress que serializa todo o seu site — base de dados, uploads de mídia, temas, plugins e configuração principal — num único arquivo portátil .wpress, que pode ser importado para qualquer instalação WordPress sem qualquer manipulação manual da base de dados. É o caminho mais rápido para uma migração completa do site ou backup pontual sem tocar no phpMyAdmin, SSH ou dumps SQL brutos.

Este guia vai além do simples clique. Abrange o fluxo de trabalho completo de migração, as restrições técnicas críticas que causam a maioria das importações falhadas, ajuste de configuração PHP, comportamento de serialização de URL e etapas de validação pós-migração que são habitualmente ignoradas e posteriormente causam incidentes em produção.

O Que o Plugin Realmente Faz Internamente

Antes de tocar no painel, compreender os mecanismos internos do plugin evita surpresas durante grandes migrações.

Quando aciona uma exportação, o All-in-One WP Migration executa a seguinte sequência:

1. Faz dump da base de dados MySQL do WordPress para um ficheiro SQL simples dentro de um diretório de trabalho temporário.
2. Serializa todos os dados de objetos PHP na base de dados (opções, configurações de widgets, meta de publicações) e reescreve URLs absolutas para um token de marcador de posição para que possam ser reescritas na importação.
3. Empacota wp-content/uploads, ficheiros de tema ativo e diretórios de plugins juntamente com o dump SQL.
4. Envolve tudo num arquivo .wpress, que é um formato personalizado — não um ZIP ou TAR padrão — com o seu próprio cabeçalho de manifesto.

Na importação, o processo inverte-se: o arquivo é desempacotado, o SQL é reproduzido na nova base de dados e os tokens de marcador de posição de URL são substituídos pelo novo URL do site. Esta etapa de reescrita de URL é a razão pela qual o plugin lida graciosamente com mudanças de domínio sem necessitar de uma passagem wp-cli search-replace separada — embora deva verificá-lo na mesma, conforme discutido na secção pós-migração.

Passo 1: Instalar o Plugin no Site de Origem

Inicie sessão no seu painel WordPress existente e navegue até Plugins > Adicionar Novo. Pesquise por All-in-One WP Migration, instale-o e ative-o. A versão gratuita é suficiente para sites abaixo do limite de tamanho de upload do seu servidor (tipicamente 128 MB a 512 MB dependendo da configuração PHP do alojamento).

Não é necessária nenhuma configuração após a ativação. O plugin regista-se na barra lateral esquerda imediatamente.

Passo 2: Exportar o Seu Website

Navegue até All-in-One WP Migration > Exportar na barra lateral do painel.

Clique em Exportar Para e selecione Ficheiro. O plugin começará a empacotar o seu site. Para um site típico abaixo de 500 MB, isto demora de 30 segundos a 3 minutos. Para sites com vários gigabytes com grandes bibliotecas de mídia, planeie entre 10 a 20 minutos.

O que é incluído na exportação:

• Dump completo da base de dados MySQL (todas as tabelas com o prefixo configurado)
• Diretório wp-content/uploads
• Temas ativos e inativos em wp-content/themes
• Todos os plugins instalados em wp-content/plugins

wp-config.php é intencionalmente excluído por razões de segurança — o próprio wp-config.php do site de destino é preservado na importação

O que é excluído por padrão:

Comentários spam
Revisões de publicações
Temas não utilizados e plugins desativados (configurável através do botão de Opções Avançadas)
Registos de erros e diretórios de cache

A secção de Opções Avançadas permite excluir tabelas específicas, caminhos de ficheiros ou tipos de publicações. Use isto para remover caches transitórios ou grandes tabelas de registos antes da exportação, o que reduz significativamente o tamanho do arquivo.
Assim que o empacotamento estiver concluído, clique em Transferir para guardar o ficheiro .wpress localmente. Guarde-o num local fiável — este ficheiro é o backup completo do seu site.
Passo 3: Preparar o Ambiente de Destino
Se estiver a migrar para um novo servidor, precisa de uma instalação WordPress limpa no destino antes de importar. A maioria dos ambientes de alojamento gerido fornece instaladores WordPress com um clique. Se estiver a trabalhar num ambiente de VPS Hosting, pode instalar o WordPress manualmente ou usar uma pilha de painel de controlo.
A instalação WordPress de destino não precisa de corresponder à origem em termos de tema, plugins ou conteúdo — a importação irá substituir tudo. No entanto, o seguinte deve estar em vigor:

O núcleo WordPress está instalado e acessível através do seu painel de administração
O utilizador da base de dados tem privilégios CREATE, DROP, INSERT, UPDATE, DELETE e ALTER na base de dados de destino
A versão PHP é compatível com os seus plugins (verifique a versão PHP do seu site de origem em Ferramentas > Saúde do Site)
O diretório wp-content tem permissão de escrita pelo processo do servidor web

Crítico: O domínio ou subdomínio do site de destino não precisa de corresponder à origem. O plugin reescreve os URLs durante a importação. No entanto, se estiver a migrar para o mesmo domínio exato (por exemplo, mover entre servidores), o tempo de propagação DNS é importante — não atualize o DNS até que a importação seja verificada.
Passo 4: Instalar o Plugin no Site de Destino
Repita o processo de instalação na nova instância WordPress: Plugins > Adicionar Novo, pesquise por All-in-One WP Migration, instale e ative.
Este passo é frequentemente ignorado quando as pessoas configuram uma instalação WordPress nova e assumem que o plugin estará presente. Não estará — o processo de importação requer que o plugin já esteja ativo no destino.
Passo 5: Aumentar o Limite de Tamanho de Upload Antes de Importar
Este é o ponto de falha mais comum. A versão gratuita do All-in-One WP Migration respeita o limite de upload PHP do servidor. Se o seu ficheiro .wpress exceder esse limite, a importação falhará silenciosamente ou apresentará um erro vago.
Verifique o seu limite atual navegando até All-in-One WP Migration > Importar. O plugin exibe o tamanho máximo de upload diretamente nesse ecrã.
Para aumentá-lo, use um dos seguintes métodos dependendo do seu nível de acesso ao servidor:
Método 1: Editar php.ini diretamente (recomendado para VPS e servidores dedicados)
upload_max_filesize = 512M
post_max_size = 512M
memory_limit = 512M
max_execution_time = 300
max_input_time = 300
Reinicie o PHP-FPM ou Apache após guardar:
sudo systemctl restart php8.1-fpm
# or for Apache with mod_php:
sudo systemctl restart apache2
Método 2: Substituir via .htaccess (ambientes de alojamento partilhado)
php_value upload_max_filesize 512M
php_value post_max_size 512M
php_value memory_limit 512M
php_value max_execution_time 300
Método 3: Substituir via wp-config.php
@ini_set('upload_max_filesize', '512M');
@ini_set('post_max_size', '512M');
@ini_set('memory_limit', '512M');
Após aplicar as alterações, atualize a página de Importação no plugin para confirmar que o novo limite está refletido. Se estiver num plano de Shared Web Hosting, contacte o seu alojamento para aumentar os limites PHP ao nível do servidor, pois as substituições .htaccess podem estar restringidas.
Alternativa para sites muito grandes: Use o plugin gratuito combinado com a extensão oficial “Basic”, ou carregue o ficheiro .wpress diretamente para wp-content/ai1wm-backups/ via FTP/SFTP e depois selecione-o no ecrã de Importação. Isto contorna completamente a restrição de tamanho de upload HTTP.
Passo 6: Importar o Arquivo
No site de destino, navegue até All-in-One WP Migration > Importar.
Clique em Importar De > Ficheiro e selecione o seu arquivo .wpress. O plugin irá carregar o ficheiro e depois iniciar o processo de restauração. Uma barra de progresso acompanha a operação.
O que acontece durante a importação:

O arquivo .wpress é desempacotado num diretório temporário em wp-content

Quando a importação estiver concluída, verá uma caixa de diálogo de confirmação. Clique em Continuar (ou Restaurar dependendo da versão do plugin) para confirmar a substituição da base de dados. Esta ação é irreversível sem um backup separado da base de dados de destino.

Será desconectado imediatamente após a conclusão da importação. Este é o comportamento esperado — a base de dados contém agora as contas de utilizador do site de origem. Inicie sessão usando as credenciais do seu site de origem.

Passo 7: Limpar Permalinks

Após iniciar sessão novamente, navegue até Definições > Permalinks. Não altere nenhuma definição. Simplesmente desloque-se até ao fundo e clique em Guardar Alterações.

Isto força o WordPress a regenerar as regras de reescrita .htaccess para o novo ambiente. Ignorar este passo resulta em todos os URLs de publicações e páginas a retornar erros 404 mesmo que o conteúdo exista na base de dados.

Se estiver a executar Nginx em vez de Apache, não existe ficheiro .htaccess. Deve garantir que o bloco de servidor Nginx inclui a diretiva try_files padrão do WordPress:

location / {
    try_files $uri $uri/ /index.php?$args;
}

Passo 8: Lista de Verificação de Validação Pós-Migração

Uma migração não está completa até que cada item desta lista seja verificado. Ignorar a validação é como sites com problemas chegam à produção.

Integridade de URL e domínio:

• Visite Definições > Geral e confirme que tanto o Endereço WordPress como o Endereço do Site refletem o URL de destino correto
• Execute uma verificação de pesquisa-substituição: instale WP-CLI no servidor e execute wp search-replace 'olddomain.com' 'newdomain.com' --dry-run para detetar quaisquer URLs que o plugin tenha perdido em dados serializados
• Verifique avisos de conteúdo misto nas ferramentas de desenvolvimento do navegador se estiver a migrar de HTTP para HTTPS

Testes funcionais:

• Teste todos os menus de navegação e links internos
• Submeta pelo menos um formulário de contacto e verifique a entrega
• Teste o fluxo de checkout WooCommerce se aplicável
• Verifique se os anexos de mídia carregam corretamente (imagens quebradas indicam frequentemente uma reescrita de URL em falta na tabela wp_posts)

Segurança e configuração:

• Confirme que os seus Certificados SSL estão ativos e HTTPS está aplicado no domínio de destino
• Reveja wp-config.php no destino — as credenciais da base de dados, o estado WP_DEBUG e os salts devem refletir o novo ambiente, não a origem
• Regenere as chaves de segurança WordPress através de Definições > Geral ou substituindo as constantes salt em wp-config.php usando o gerador de chaves secretas WordPress

Cache:

• Limpe todas as camadas de cache: cache de objetos (Redis/Memcached), plugins de cache de página (WP Rocket, W3 Total Cache) e quaisquer caches CDN
• Desative e reative os plugins de cache para forçá-los a detetar os novos caminhos do ambiente

Comparação: All-in-One WP Migration vs. Métodos Alternativos de Migração

Migrar para um VPS ou Servidor Dedicado

Se estiver a mover de alojamento partilhado para um ambiente de VPS Hosting ou Servidores Dedicados, o fluxo de trabalho do All-in-One WP Migration é idêntico, mas a configuração do servidor de destino requer atenção adicional:

• Instale uma pilha LAMP ou LEMP (Apache/Nginx, MySQL/MariaDB, PHP)
• Configure um host virtual apontando para o diretório raiz de documentos WordPress
• Crie uma base de dados MySQL dedicada e utilizador com privilégios adequados
• Instale o núcleo WordPress antes de executar a importação do plugin
• Configure as definições do pool PHP-FPM para corresponder ou exceder os requisitos de recursos do site de origem

Para equipas que preferem uma interface de painel de controlo gerido, um VPS com cPanel reduz significativamente a sobrecarga de configuração do servidor — o cPanel fornece um instalador WordPress com um clique, seletor de versão PHP e gestor de ficheiros que simplificam a configuração pré-importação.

Erros Comuns e Como Corrigi-los

“Importação falhada: não foi possível extrair o arquivo”

Isto normalmente significa que o ficheiro .wpress está corrompido, o upload foi interrompido ou o espaço em disco no destino é insuficiente. Verifique se o tamanho do ficheiro corresponde ao original, verifique o espaço em disco disponível com df -h e recarregue via SFTP diretamente para wp-content/ai1wm-backups/.

“Tempo máximo de execução excedido”

A diretiva PHP max_execution_time é demasiado baixa para o tamanho da importação. Aumente-a para 300 ou 600 segundos em php.ini ou .htaccess conforme mostrado acima.

“O ficheiro carregado excede a diretiva upload_max_filesize”

O limite de tamanho de upload não foi aumentado, ou a alteração não foi aplicada ao ficheiro de configuração PHP correto. Execute php -i | grep upload_max_filesize a partir da linha de comandos para confirmar qual php.ini está ativo.

php -i | grep upload_max_filesize
php -i | grep "Loaded Configuration File"

Ecrã branco da morte após importação

Ative WP_DEBUG temporariamente em wp-config.php para revelar o erro PHP real:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Depois verifique /wp-content/debug.log para o erro específico. As causas comuns são um plugin incompatível com a versão PHP de destino ou esgotamento do limite de memória.

Imagens quebradas após migração

Execute uma pesquisa-substituição direcionada na base de dados para o domínio antigo nas tabelas wp_posts e wp_postmeta. Usando WP-CLI:

wp search-replace 'https://olddomain.com' 'https://newdomain.com' wp_posts wp_postmeta --precise --report-changed-only

Matriz de Decisão Técnica: Quando Usar o All-in-One WP Migration

Principais Conclusões Práticas

• Carregue sempre o ficheiro .wpress via SFTP diretamente para wp-content/ai1wm-backups/ para sites acima de 200 MB — isto evita todas as restrições de tamanho de upload HTTP.
• Aumente upload_max_filesize, post_max_size, memory_limit e max_execution_time no destino antes de iniciar a importação, não após encontrar um erro.
• O plugin exclui wp-config.php do arquivo — as credenciais da base de dados de destino são preservadas, mas verifique WP_DEBUG, WP_SITEURL e os salts de segurança manualmente após a importação.
• Limpe sempre os permalinks imediatamente após a importação. No Nginx, verifique se a diretiva try_files está presente no bloco de servidor.
• Execute wp search-replace --dry-run após qualquer migração envolvendo uma mudança de domínio para detetar remanescentes de URL serializados que o plugin possa ter perdido.
• Confirme que SSL está ativo no destino antes de entrar em produção — uma incompatibilidade de certificado SSL após migração é uma causa comum de avisos de segurança do navegador que prejudicam a confiança do utilizador.
• Para migrações em produção, teste sempre num ambiente de teste primeiro, especialmente ao mudar versões PHP ou ao mover entre pilhas de servidores significativamente diferentes.

Perguntas Frequentes

O All-in-One WP Migration funciona para mover o WordPress para um domínio diferente?

Sim. O plugin reescreve automaticamente o domínio de origem para o domínio de destino durante a importação usando um processo de substituição de tokens no dump SQL. Após a importação, verifique se a reescrita foi bem-sucedida verificando Definições > Geral e executando um WP-CLI search-replace --dry-run para detetar quaisquer URLs incorporadas em dados PHP serializados que o plugin possa ter perdido.

Qual é o tamanho máximo de ficheiro suportado pela versão gratuita?

A versão gratuita não tem limite de tamanho codificado no próprio plugin — a restrição vem inteiramente das diretivas PHP upload_max_filesize e post_max_size do servidor. Em muitos alojamentos partilhados, o padrão é 128 MB. Pode contornar completamente esta restrição carregando o ficheiro .wpress via SFTP para wp-content/ai1wm-backups/ e selecionando-o no ecrã de Importação, o que ignora o mecanismo de upload HTTP.

A migração irá substituir completamente a base de dados do site de destino?

Sim. A importação elimina todas as tabelas existentes na base de dados de destino e substitui-as pelas tabelas do site de origem. Faça backup da base de dados de destino antes de importar se contiver dados que precise de preservar.

Posso usar o All-in-One WP Migration para WordPress Multisite?

A versão gratuita não suporta migrações de rede Multisite. A “Extensão Multisite” premium é necessária para exportar e importar uma rede Multisite completa. Subsites individuais dentro de uma rede podem por vezes ser migrados como sites autónomos usando a versão gratuita, mas isto requer limpeza manual das entradas de base de dados específicas da rede.

Por que sou desconectado imediatamente após a conclusão da importação?

Este é o comportamento correto. A importação substitui toda a base de dados, incluindo a tabela wp_users, com os dados do site de origem. A conta de administrador do seu site de destino já não existe — as contas de utilizador do site de origem estão agora ativas. Inicie sessão usando o nome de utilizador e palavra-passe do site de origem original.