Ao usar o instalador do Duplicator, você pode encontrar vários problemas relacionados à UI ou a arquivos. Este guia abrange problemas comuns da UI do Instalador e suas soluções.

Arquivo Não Encontrado

Cada backup do Duplicator inclui um arquivo installer.php exclusivo vinculado a um arquivo específico (.zip ou .daf). Se eles não corresponderem, você verá uma mensagem de erro, como a seguinte:

• Arquivo não encontrado!
• Detectada incompatibilidade entre instalador e arquivo

Se você vir uma dessas mensagens, confira as soluções abaixo:

Solução 1: Localize o Nome Correto do Arquivo

Certifique-se de que o nome do arquivo corresponda ao esperado pelo instalador.

Vá para Duplicator Pro » Backups, clique no botão + e, em seguida, clique no botão “Ver Detalhes”.

Observação: Se você estiver usando o Duplicator Lite, vá para Duplicator Lite » Backups, clique no botão Detalhes do Backup.

Em seguida, expanda a seção Geral e observe o nome completo do arquivo de backup em Arquivos.

Por fim, vá para o backup que você baixou e verifique o nome completo, que estará neste formato: [nome-completo-único]_archive.zip

Solução 2: Extraia o Instalador de Backup

Extraia o arquivo do Instalador do arquivo usando este guia. Instruções sobre como extrair manualmente um arquivo DAF podem ser encontradas aqui.

Solução 3: Validar Downloads

Certifique-se de que o arquivo do backup foi totalmente baixado e carregado corretamente. Além disso, compare o tamanho do arquivo em seu computador local com o tamanho exibido na tela Backups. Se não corresponderem, baixe e carregue o arquivo novamente.

Solução 4: Tente um Navegador Diferente

Se o problema persistir, tente o seguinte:

• Use um navegador diferente sem extensões.
• Se os sites estiverem sendo executados atrás de um proxy, considere desativar o proxy temporariamente e, em seguida, limpe o cache DNS.
• Considere desativar temporariamente quaisquer VPNs que você esteja usando ou qualquer software de firewall.

Erros de JavaScript

Se a interface do installer.php não estiver carregando corretamente devido a erros de JavaScript, tente o seguinte:

1. Verifique se o servidor inseriu automaticamente um arquivo .htaccess no diretório dup-installer.
2. Exclua o arquivo .htaccess. (Ative "exibir arquivos ocultos" no FTP, se necessário.)
3. Limpe o cache do seu navegador e recarregue o installer.php.

Observação: Às vezes, os servidores podem inserir um arquivo .htaccess em uma das subpastas da pasta dup-installer.

Problemas do Safari/Macintosh

Alguns sistemas Mac descompactam arquivos automaticamente, causando problemas com o Duplicator. O Instalador do Duplicator procura por um arquivo de backup .zip ou .daf, portanto, problemas podem ocorrer se ele for baixado como arquivos separados e extraídos.

Solução 1: Evitar Descompactação Automática no Safari

1. Abra o Safari.
2. Vá para Preferências » Geral.
3. Desmarque “Abrir arquivos seguros após o download”.
4. Baixe o arquivo de backup novamente.

Solução 2: Verificar Integridade do Backup

Se durante o processo de instalação, você notar que o backup é extraído com um diretório com o mesmo nome exato do backup, ou em alguns casos uma pasta chamada __MACOSX, isso significa que o arquivo de backup foi modificado.

Para obter uma cópia bruta do arquivo archive.zip/daf, verifique os seguintes locais:

• Duplicator Pro: /seu_site/wp-content/backups-dup-pro (ou qualquer caminho de armazenamento que você definir)
• Duplicator Lite:
  • /public_html/wp-content/backups-dup-lite/
  • /public_html/wp-snapshots/ (caminho legado)

Você também pode recriar o backup dos arquivos:

1. Extraia o arquivo de backup em seu computador local e navegue até o arquivo installer-backup.php.
2. Selecione todos os arquivos/pastas e recrie o archive.zip para que o installer-backup.php esteja na raiz do backup.
3. Em alguns casos, pode ser necessário renomear o backup criado na segunda etapa para o nome original do arquivo de backup extraído na primeira etapa acima.
4. Coloque o arquivo de backup recém-organizado no mesmo local do arquivo installer.php e tente novamente.

Observação: Embora recriar o backup dos arquivos funcione na maioria dos casos, a chave para resolver o problema é impedir que seu navegador/sistema operacional ou programa externo altere a estrutura do arquivo de backup quando ele for baixado para o seu computador.

Instalador Inválido

Se a abertura do installer.php em um navegador mostrar código corrompido ou um prompt de download, provavelmente há um problema de configuração do servidor, ou o arquivo do Instalador foi corrompido quando o servidor o serviu como parte do processo de download.

Solução 1: Corrigir Exibição de Texto Simples

Se o installer.php for exibido como texto simples, modifique o arquivo .htaccess ou httpd.conf adicionando as seguintes linhas:

AddType application/x-httpd-php .php .htm .html
AddHandler x-httpd-php .php .htm .html

Observação: Use um mecanismo de busca (como o Google) para sua configuração de hospedagem (por exemplo, “MAMP AddType PHP”) para obter instruções específicas. Por exemplo, um problema semelhante usando o MAMP pode ser encontrado aqui.

Solução 2: Corrigir Exibição de Texto Binário

Se o installer.php mostrar caracteres binários ou hexadecimais em vez de executar, como

1f8b 0800 0000 0000 0003 ecfd 7b57 1bb9d228 0eff 9dbd d6fe 0e8d 7706 ecd0 363609b9 d8e9 7813 7012 26dc 8221 2401 86a7...

ou

Aviso: Caractere inesperado na entrada: '?' (ASCII=17) estado=0

Então o servidor web pode ter alguns problemas com o download do arquivo para o seu computador. A maneira mais fácil de obter uma cópia boa do instalador é tentar o seguinte:

• Download Direto por FTP:
  1. Ao transferir os arquivos de backup do seu cliente FTP, certifique-se de que ele esteja no modo binário, pois o modo ASCII pode corromper o arquivo zip. O backup pode ser encontrado usando estes caminhos de arquivo:
     • Duplicator Pro: /seu_site/wp-content/backups-dup-pro (ou qualquer caminho de armazenamento que você definir)
     • Duplicator Lite:
       • /public_html/wp-content/backups-dup-lite/
       • /public_html/wp-snapshots/ (caminho legado)
  2. Encontre o Instalador com um nome de arquivo associado ao backup correto e baixe-o.
  3. Abra o arquivo installer.php em um editor de texto como o Notepad++. O código do arquivo deve ser um arquivo PHP normal.
• Use o instalador de backup: Outra opção é abrir o arquivo archive.zip e encontrar o arquivo installer-backup.php. este arquivo será uma cópia exata do arquivo original installer.php. Para mais detalhes, confira este guia. Instruções sobre como extrair manualmente um arquivo DAF podem ser encontradas aqui.
• Contate o Host: Informe seu host que o download de arquivos precisa ser configurado para o modo binário, e não ASCII.

Solução 3: Corrigir Prompt de Download

Se a navegação para o installer.php solicitar um download em vez de executá-lo, você pode ter um arquivo .htaccess corrompido ou não configurado para funcionar corretamente. Para testar isso:

1. Crie um arquivo PHP em branco, como test.php
2. Faça o upload deste arquivo para o mesmo diretório do installer.php.
3. Se o arquivo test.php também for baixado em vez de executado, seu servidor não está processando PHP corretamente.

Para corrigir isso, entre em contato com seu host e diga a eles que seu site não está processando arquivos PHP corretamente.

Solução 4: Corrija Erros de Análise

Se o installer.php apresentar erros como:

Erro de análise: erro de sintaxe, $end inesperado, esperando T_VARIABLE ou T_DOLLAR_OPEN_CURLY_BRACES ou T_CURLY_OPEN em … installer.php na linha 1300

Então a codificação do seu arquivo não está sendo aceita corretamente pelo seu servidor web. Abaixo estão algumas opções:

1. Em muitos casos, a transferência de arquivos de um servidor para outro pode corromper o instalador. Para resolver este problema, consulte a Solução nº 2 acima. Em muitos casos, alterar o modo FTP de ASCII para binário pode corrigir este problema.
2. Se a primeira opção não resolver o problema, você pode usar um programa como o Notepad++. Abra o arquivo installer.php e altere a configuração de codificação, encontrada na barra de ferramentas superior, de ANSI para UTF-8. Tente converter de um formato para o outro. Em seguida, salve o arquivo e faça o upload novamente do arquivo do instalador para o servidor para ver qual versão funciona.

É isso! Se você estiver enfrentando problemas com o instalador ou com arquivos compactados no Duplicator, os passos acima devem ajudar a resolvê-los. Se os problemas persistirem, considere verificar com seu provedor de hospedagem sobre problemas de configuração do servidor.

Você está procurando migrar um site com zero tempo de inatividade? Se sim, confira nosso guia completo aqui sobre “Como Migrar um Site com Zero Tempo de Inatividade“.