Mudar o domínio ou o URL do WordPress

Ao mudar de domínio, mover o WordPress para um subdiretório ou publicar uma cópia, pode ser necessário alterar o seu URL principal. O método depende do acesso que mantém à instalação.

Antes de usar qualquer um destes métodos, guarde uma cópia recuperável dos ficheiros e da base de dados, confirme que o novo domínio aponta para o diretório adequado e que o seu certificado HTTPS funciona. Este guia aborda uma instalação individual; uma rede Multisite precisa de um procedimento específico.

A seguir descrevemos três métodos principais para mudar o URL do WordPress, ordenados do mais simples ao mais técnico.

Método 1: A partir do painel de administração do WordPress (wp-admin)

Esta é a forma mais simples e recomendada quando temos acesso ao painel de administração do WordPress.

1. Aceda ao painel de administração do WordPress (wp-admin)

2. Vá a Definições → Geral

3. Altere os campos:

   • Endereço do WordPress (URL): o URL onde estão os ficheiros principais do WordPress
   • Endereço do site (URL): o URL que os visitantes verão

4. Clique em Guardar alterações

Importante: certifique-se de que os dois URL estão corretos antes de guardar, já que um erro pode deixá-lo sem acesso ao painel de administração.

Método 2: Editar o ficheiro wp-config.php

Utilize este método quando não tiver acesso ao painel de administração por causa da mudança de URL.

1. Ligue-se à sua conta por FTP ou através do gestor de ficheiros
2. Localize e edite o ficheiro wp-config.php na raiz da sua instalação do WordPress
3. Se estas constantes já existirem, altere os seus valores sem as duplicar. Se não existirem, acrescente as linhas seguintes antes do comentário «That's all, stop editing!» (ou o seu equivalente traduzido), antes do carregamento do WordPress:

define('WP_HOME','https://oseudominio.com');
define('WP_SITEURL','https://oseudominio.com');

Substitua oseudominio.com pelo seu domínio real. WP_SITEURL deve indicar onde estão os ficheiros do WordPress e WP_HOME o endereço público do site; só serão iguais se as duas localizações coincidirem.

Estas constantes prevalecem sobre home e siteurl na base de dados, mas não alteram os seus valores. Enquanto estiverem definidas, também não poderá editar os endereços em Definições > Geral. Se as utilizar para recuperar o acesso, atualize depois as opções guardadas e retire as constantes para evitar que o URL antigo volte a aparecer.

Método 3: Editar diretamente a base de dados (phpMyAdmin)

Este método é mais técnico e deve ser usado com precaução.

Processo de edição:

1. Aceda ao phpMyAdmin a partir do painel de controlo do seu alojamento

2. Selecione a base de dados do seu WordPress

3. Verifique DB_NAME e $table_prefix no wp-config.php para identificar a base e a tabela corretas. Localize wp_options ou a tabela equivalente com esse prefixo

4. Procure as linhas seguintes e edite os seus valores na coluna option_value:

   • home: substitua pelo novo URL (exemplo: https://oseudominio.com)
   • siteurl: substitua pelo novo URL (exemplo: https://oseudominio.com)

5. Guarde as alterações

Passo adicional recomendado: atualizar referências internas

Depois de mudar o URL principal com qualquer um dos métodos anteriores, é muito recomendável atualizar todas as referências internas que o WordPress guarda na base de dados, já que muitos elementos (imagens, ligações internas, widgets, etc.) podem continuar a apontar para o URL anterior.

Antes de o fazer, crie uma cópia recuperável da base de dados. Não execute uma substituição SQL direta nem edite a exportação como texto: o WordPress e os seus plugins guardam dados serializados que ficariam danificados se o comprimento de um URL mudar.

Porque é necessário este passo adicional?

Mesmo depois de mudarmos o URL principal do WordPress, a base de dados pode conter milhares de referências ao URL antigo em:

• Conteúdo de artigos e páginas
• URL de imagens e ficheiros multimédia
• Configurações de widgets e menus
• Opções de temas e plugins

Com o Better Search Replace

1. Instale o plugin Better Search Replace a partir do repositório oficial do WordPress

2. Vá a Ferramentas → Better Search Replace

3. Configure os campos:

   • Search for: o URL antigo completo (exemplo: https://dominioviejo.com)
   • Replace with: o novo URL completo (exemplo: https://dominionuevo.com)
   • Select tables: selecione as tabelas da instalação que vai alterar
   • Run as dry run?: deixe ativado na primeira execução para rever o número de alterações

4. Verifique o resultado da simulação e, só se estiver correto, repita a operação com essa opção desativada.

Não substitua apenas o domínio isolado: poderia alterar endereços de email ou outros valores que não são URL. Trate em separado as variantes http, https, www ou subdiretórios que tenha confirmado na base.

Com o WP-CLI (método avançado)

Se tiver acesso ao WP-CLI, execute o comando a partir da pasta da instalação correta, ou indique o seu caminho com --path. Pode simular a substituição assim:

wp search-replace 'https://dominioviejo.com' 'https://dominionuevo.com' --skip-columns=guid --dry-run

Por omissão, o WP-CLI processa as tabelas registadas para essa instalação; verifique se algum plugin utiliza outras tabelas antes de alargar o alcance. Não acrescente indiscriminadamente todas as tabelas da base se nela convivem várias aplicações.

Execute primeiro com --dry-run para simular e depois sem essa opção para aplicar as alterações. O WP-CLI respeita os dados serializados; --skip-columns=guid evita alterar os identificadores permanentes dos artigos.