# Migrar um Site do cPanel para o KapsuleHost

Source: https://support.kapsulehost.com/pt-pt/sites-migrate-cpanel

A maioria das pessoas muda um site do cPanel sem tocar num único ficheiro: a KapsuleHost tem uma migração guiada que copia os seus ficheiros e base de dados por si, enquanto o site antigo se mantém ativo. Este guia aborda os três caminhos de migração, qual escolher, e a via manual para os casos em que preferir fazê-lo você mesmo.

A migração é gratuita em todos os planos. Não há taxa de configuração nem cobrança por site.

## Antes de Começar

> **Note:** Mantenha a sua hospedagem antiga ativa até que o novo site esteja verificado e o seu domínio tenha sido redirecionado. Cancelar cedo demais é o único erro deste processo que não pode ser revertido, porque a origem da cópia desaparece com ele. Dê-se uma semana de sobreposição.

Tenha isto pronto:

- O domínio em que o site funciona atualmente.
- Acesso à administração do WordPress do site, ou ao seu login de cPanel ou FTP.
- O login da sua entidade registadora de domínios, para o passo final.
- Um plano de hospedagem KapsuleHost com um espaço de site livre.

## Escolher um Caminho de Migração

Abra **Migrações** na barra lateral esquerda do KPanel, aceda à migração de um website, e introduza o endereço atual do seu site. A KapsuleHost verifica o site, identifica a plataforma, e oferece três caminhos.

![Opções de caminho de migração no KPanel](https://support.kapsulehost.com/help/screenshots/sites-migrate-cpanel.89d2d04b.webp)

| Caminho | Como funciona | Ideal para |
|---|---|---|
| **KapsuleHost Migrator Plugin** | Instale um plugin gratuito no site de origem e cole um token de utilização única. Nenhuma credencial de hospedagem sai das suas mãos. | Sites WordPress e WooCommerce. A opção mais rápida e a que a maioria das pessoas deve escolher. |
| **Credenciais de hospedagem** | Dê-nos acesso temporário de FTP, SFTP ou cPanel, além dos dados da base de dados. Nós tratamos de tudo diretamente. | Qualquer plataforma, incluindo sites que não sejam WordPress. |
| **A nossa equipa trata disso** | Conte-nos sobre o site e um engenheiro de migração trata de tudo manualmente. | Configurações complexas, vários sites de uma vez, ou se simplesmente preferir não o fazer. |

Os três são gratuitos, e pode alternar entre eles em qualquer momento do assistente.

### O caminho do plugin

1. Escolha **KapsuleHost Migrator Plugin**.
2. Descarregue `kapsule-migrator.zip` a partir do ecrã.
3. No seu site atual, vá a **Plugins**, depois **Add New**, depois **Upload Plugin**. Carregue o ficheiro zip e ative-o.
4. Abra **KapsuleHost Migrate** no menu de administração do WordPress.
5. Copie o token do KPanel, cole-o no plugin e clique em **Iniciar Migração**.

O KPanel deteta a ligação automaticamente e leva-o para um ecrã de progresso em tempo real. Os ficheiros, a base de dados e os uploads são copiados por si. O token expira ao fim de 48 horas; gere um novo a partir do mesmo ecrã se precisar.

### O caminho das credenciais

Escolha **Credenciais de hospedagem** e preencha duas secções: dados de FTP, SFTP ou SSH (nome do servidor, utilizador, palavra-passe) e dados da base de dados (servidor, nome, utilizador, palavra-passe). Há um campo de notas para qualquer outra informação útil, como o seu endereço de cPanel.

> **Note:** As credenciais são encriptadas antes de serem armazenadas e só podem ser lidas pelo sistema de migração automatizado, não pela equipa. São permanentemente eliminadas no prazo de 24 horas após a conclusão da migração, e nunca são usadas para nada além de copiar o seu site.

### O caminho da equipa

Conte-nos sobre o site e a sua preferência de calendário. Um engenheiro de migração responde no prazo de quatro horas úteis com um plano, e nada entra em produção sem a sua aprovação.

## O Que Acontece a Seguir

Seja qual for o caminho escolhido, a estrutura é a mesma:

1. A cópia é executada em segundo plano. O seu site existente mantém-se ativo e intocado durante todo o processo.
2. O seu novo site fica disponível para revisão num endereço temporário.
3. Você verifica-o e aprova.
4. Só então o DNS muda.

O seu site original permanece intocado no seu fornecedor antigo, e tem uma janela de reversão de 7 dias: durante sete dias após o seu site entrar em produção, um clique na página da migração (**Voltar ao fornecedor anterior**) devolve o seu domínio a esse fornecedor, ou mostra os registos exatos a restaurar caso o seu DNS esteja na sua própria entidade registadora. Consulte [Mudar de Ideias Depois de Entrar em Produção](https://support.kapsulehost.com/pt-pt/migrations-overview). Mantenha a sua hospedagem antiga durante pelo menos esses sete dias.

## Rever Antes de Mudar

Este é o passo que vale a pena levar a sério, porque depois de o DNS mudar, todos os visitantes veem exatamente o que você aprovou.

Carregue o endereço temporário e verifique:

- A página inicial e duas ou três páginas internas.
- Imagens, incluindo qualquer coisa num slider ou galeria.
- Qualquer formulário de contacto ou reserva, submetido de forma real.
- Início de sessão na administração, e uma edição guardada.
- Numa loja: uma encomenda de teste completa até à página de confirmação.

Se alguns URLs ainda apontarem para o domínio antigo, execute uma pesquisa e substituição: [Executar uma Pesquisa e Substituição](https://support.kapsulehost.com/pt-pt/wordpress-search-replace).

## Apontar o Seu Domínio

Quando a revisão estiver impecável, mude o domínio. Pode alterar os seus servidores de nomes para os da KapsuleHost, que é a opção mais simples e traz a gestão de DNS para o KPanel, ou manter o seu fornecedor de DNS atual e redirecionar os registos do site.

As instruções completas encontram-se em [Alterar os Seus Servidores de Nomes](https://support.kapsulehost.com/pt-pt/nameservers) e [Ligar um Domínio Personalizado ao Seu Website](https://support.kapsulehost.com/pt-pt/custom-domain-for-website).

As alterações de DNS demoram entre alguns minutos e algumas horas a chegar a todos. Durante essa janela, alguns visitantes continuarão a cair no fornecedor antigo, razão pela qual o deve manter ativo.

> **Tip:** Aponte o seu domínio numa manhã tranquila de dia útil, não numa sexta-feira à noite. Se algo precisar de ajuste, quer estar acordado e quer que estejamos contactáveis.

## Migrar Manualmente

Se preferir fazê-lo você mesmo, ou se o site não estiver numa plataforma suportada, a via manual continua a funcionar.

### 1. Criar o site

**Websites**, depois **Adicionar Website**, depois **Novo Website**. Escolha o tipo de site que corresponde ao que está a mover. O site é disponibilizado num endereço temporário que pode testar de imediato. Consulte [Criar o Seu Primeiro Website](https://support.kapsulehost.com/pt-pt/creating-your-first-website).

### 2. Exportar do cPanel

Descarregue os ficheiros do site, seja através do File Manager do cPanel, seja via FTP. Para WordPress, isso é tudo o que está em `public_html`, incluindo `wp-config.php`. O Backup Wizard do cPanel produz tudo isso como um único download, se preferir.

Depois exporte a base de dados: abra o phpMyAdmin no cPanel, selecione a base de dados, e use **Export**, depois **Quick**, depois **Go**.

### 3. Carregar os ficheiros

1. No KPanel, abra o seu novo site, depois **Definições**, depois **SFTP**.
2. Em **Contas SFTP**, introduza um nome de utilizador e clique em **Create**.
3. Copie o servidor, a porta, o utilizador e a palavra-passe apresentados. A palavra-passe é mostrada uma única vez e não pode ser recuperada depois.
4. Ligue-se com qualquer cliente SFTP e carregue os seus ficheiros para o diretório do site.

Os detalhes completos sobre a conta SFTP e o acesso SSH nativo estão em [Ligar via SFTP](https://support.kapsulehost.com/pt-pt/sftp-access).

### 4. Importar a base de dados

1. Abra o site, depois **Base de dados**.
2. Clique em **Abrir phpMyAdmin**. A sua sessão é iniciada automaticamente, sem palavra-passe separada.
3. Selecione a sua base de dados, clique em **Import**, escolha o ficheiro `.sql`, e clique em **Go**.

Consulte [Aceder à Sua Base de Dados com o phpMyAdmin](https://support.kapsulehost.com/pt-pt/sites-phpmyadmin) para limites de importação e como lidar com um dump grande.

### 5. Atualizar o wp-config.php

O separador Database apresenta os novos dados de ligação. Copie-os para `wp-config.php` usando **Definições**, depois **Gestor de Ficheiros**:

```php
define( 'DB_NAME', 'your-new-database-name' );
define( 'DB_USER', 'your-new-database-user' );
define( 'DB_PASSWORD', 'your-new-password' );
define( 'DB_HOST', '127.0.0.1' );
```

> **Warning:** Não transporte as regras de `.htaccess` do fornecedor antigo. A KapsuleHost não utiliza Apache, pelo que essas regras não funcionarão e podem induzi-lo em erro, levando-o a pensar que um redirecionamento está em vigor quando não está. Recrie-as no KPanel: [Compreender o .htaccess na KapsuleHost](https://support.kapsulehost.com/pt-pt/wordpress-htaccess).

### 6. Testar e depois redirecionar

Carregue o endereço temporário, percorra a lista de revisão acima, depois aponte o seu domínio.

## Resolução de Problemas

**O site carrega mas não tem estilo.** URLs absolutos antigos na base de dados. Execute uma pesquisa e substituição do endereço antigo para o novo.

**"Error establishing a database connection".** As credenciais em `wp-config.php` não correspondem ao separador Database. Verifique se `DB_HOST` é `127.0.0.1`.

**A importação da base de dados falha a meio.** O dump é maior do que o limite de upload do phpMyAdmin. Comprima-o para `.sql.gz`, divida-o em ficheiros mais pequenos, ou abra um ticket e nós importamo-lo por si.

**Algumas páginas dão erro 404 depois da mudança.** Limpe as regras de rewrite: **WordPress**, depois **Ações Rápidas**, depois **Limpar Rewrites**. Consulte [Corrigir Problemas de Permalinks do WordPress](https://support.kapsulehost.com/pt-pt/wordpress-permalink-issues).

**O cadeado está em falta ou apresenta um aviso.** Conteúdo misto proveniente de URLs HTTP ainda na base de dados: [Corrigir Avisos de Conteúdo Misto](https://support.kapsulehost.com/pt-pt/ssl-mixed-content).