blog
Painéis

Regra que coloquei no htaccess sumiu depois de mexer no painel

Como ler o arquivo depois que o painel escreveu nele, identificar os blocos que têm dono e posicionar a sua regra num lugar que a próxima alteração pela interface não apaga.

JR · · 8 min de leitura · 1 tabela · 1 bloco de código

Resposta curta: a regra some porque telas do cPanel e plugins do WordPress apagam e reescrevem o trecho entre os próprios marcadores BEGIN e END. Se a sua regra estava ali dentro, foi junto. Coloque-a no topo do arquivo, fora de qualquer marcador, e faça backup antes.

Neste artigo
  1. Por que a regra que você colocou no .htaccess sumiu
  2. Como abrir o .htaccess sem risco
  3. Como reconhecer os blocos que têm dono
  4. Em que ordem o Apache lê essas regras
  5. Onde colocar a sua regra para ela sobreviver
  6. Como recuperar uma regra que já sumiu
  7. Quando o .htaccess não é o melhor lugar

Por que a regra que você colocou no .htaccess sumiu

Algumas telas do cPanel e alguns plugins do WordPress não editam o .htaccess linha por linha. Eles procuram um trecho delimitado por comentários próprios, apagam esse trecho inteiro e escrevem uma versão nova. Se a sua regra estava dentro desse trecho, ela vai embora junto, sem aviso.

O arquivo em si não foi corrompido. O problema é de posição: a regra estava num lugar que outra ferramenta considera dela.

A documentação oficial do cPanel reúne sob a tag .htaccess as interfaces que gravam nesse arquivo. Use essa página para conferir, na sua versão do painel, quais telas mexem nele. Este guia não afirma quais telas causam o problema com mais frequência, porque não há fonte para isso. O foco é outro: ler o arquivo depois que o painel escreveu nele e escolher um lugar seguro para a sua regra.

Como abrir o .htaccess sem risco

Antes de qualquer edição, faça uma cópia. Um erro de sintaxe no .htaccess derruba o site inteiro com erro 500, e a cópia é o que permite voltar em segundos.

Como mostrar arquivos ocultos no Gerenciador de Arquivos

  1. No cPanel, abra Gerenciador de Arquivos (seção Arquivos).
  2. Clique em Configurações, no canto superior direito.
  3. Marque Mostrar arquivos ocultos (dotfiles) e salve.

Sem isso, o .htaccess não aparece na lista, porque o nome começa com ponto.

Como fazer a cópia de segurança do .htaccess

  1. Entre em public_html (ou na pasta raiz do domínio, se for um domínio adicional).
  2. Clique com o botão direito em .htaccess e escolha Copiar.
  3. Abre uma caixa com um campo de destino. Esse campo pede o caminho completo, não só o nome. Apague o que estiver nele e digite, por exemplo, /public_html/.htaccess.bak-2026-11-11 (para domínio adicional, use o caminho da pasta dele). Clique no botão de confirmar a cópia (Copy File(s), conforme o idioma do painel). A cópia aparece na listagem ao lado do original.

Para desfazer qualquer alteração, basta apagar o .htaccess atual e renomear a cópia de volta para .htaccess.

Como abrir o .htaccess só para leitura

Clique com o botão direito em .htaccess e escolha Edit. Por enquanto, só leia. O objetivo é identificar os blocos, descritos na próxima seção.

Como reconhecer os blocos que têm dono

Um bloco com dono começa e termina com um comentário (linha iniciada por #) que contém BEGIN e END, muitas vezes com um aviso do tipo "do not edit". Tudo entre essas duas linhas pertence à ferramenta que escreveu o marcador.

O exemplo abaixo é fictício, montado para ilustrar a leitura. O texto exato dos marcadores muda conforme a versão do painel e do plugin, então confira sempre no seu próprio arquivo.

# Minhas regras (bloco do usuário, fora de qualquer marcador)
RewriteEngine On
RewriteCond %{HTTP_HOST} ^www\.exemplo\.com\.br$ [NC]
RewriteRule ^(.*)$ https://exemplo.com.br/$1 [R=301,L]
# Fim das minhas regras

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

# php -- BEGIN cPanel-generated handler, do not edit
# (linhas que definem a versão do PHP)
# php -- END cPanel-generated handler, do not edit

O bloco do usuário no exemplo faz uma coisa só: tira o www do endereço. Linha a linha:

Não copie o bloco como está: troque exemplo.com.br pelo seu domínio nas duas linhas, mantendo a barra antes de cada ponto na linha RewriteCond. Se colar sem trocar, o seu site passa a redirecionar todos os visitantes para exemplo.com.br.

A tabela resume como tratar cada tipo de trecho que você vai encontrar.

O que aparece no arquivo Quem costuma escrever O que acontece com o que estiver dentro
Comentário com "cPanel-generated" e BEGIN/END Telas do cPanel, como a de versão do PHP e a de diretivas do PHP Reescrito quando você salva a tela correspondente
# BEGIN WordPress / # END WordPress O próprio WordPress, ao salvar Links Permanentes Reescrito ao salvar as configurações de links
BEGIN/END com nome de plugin Plugins de cache, segurança ou redirecionamento Reescrito quando o plugin atualiza a configuração
Linhas soltas de Rewrite, Auth ou bloqueio de IP, sem marcador Telas como Redirecionamentos, Proteção de Hotlink, Privacidade de Diretório ou Bloqueador de IP, ou edição manual Depende da tela; trate como frágil e confira após cada uso
Seu bloco, fora de qualquer marcador Você Não pertence a nenhuma ferramenta, mas pode ser deslocado por uma tela que reescreve o arquivo

A linha mais importante da tabela é a última: um bloco seu, bem identificado e fora de qualquer BEGIN/END, é o que tem mais chance de sobreviver. Mas nenhum painel garante isso por escrito, então a conferência depois de cada alteração continua necessária.

Onde cada trecho do .htaccess pertenceBloco do usuárioFora de qualquer BEGIN/END, no topoBloco do WordPressEntre BEGIN e END, reescrito ao salvar Links P…Bloco do cPanelMarcador cPanel-generated, reescrito pela tela…
Quem reescreve cada trecho do .htaccess

Em que ordem o Apache lê essas regras

A posição no arquivo importa por dois motivos: o que sobrevive e o que funciona.

Por que a posição das regras dentro do arquivo importa

O Apache processa as regras de reescrita (RewriteRule) na ordem em que aparecem. Quando uma regra com a flag [L] casa com a URL, as regras seguintes não são avaliadas naquela passada. Por isso, um redirecionamento colocado depois do bloco do WordPress pode nunca rodar: a regra RewriteRule . /index.php [L] captura a requisição antes.

Na prática: redirecionamentos de domínio, de www, de HTTPS ou de URLs antigas devem ficar acima do bloco do WordPress.

Por que a regra da pasta de cima pode deixar de valer na subpasta

Cada pasta pode ter o próprio .htaccess. O Apache aplica primeiro o da pasta superior e depois o da subpasta. Para regras de reescrita há um detalhe: se a subpasta tem RewriteEngine On e regras próprias, por padrão as regras de reescrita da pasta superior deixam de valer ali. Isso explica um sintoma comum: você instala um segundo WordPress ou outro sistema numa subpasta (por exemplo, public_html/loja), ele cria o próprio .htaccess com RewriteEngine On e regras próprias, e um redirecionamento que funcionava na raiz para de funcionar dentro dela. A Privacidade de Diretório também cria um .htaccess na pasta protegida, mas grava diretivas de autenticação (linhas que começam com Auth), não de reescrita. Sozinha, ela não desliga as regras de reescrita herdadas da raiz.

Onde colocar a sua regra para ela sobreviver

Com o arquivo lido e o backup feito, siga estas regras de posicionamento:

  1. Nunca escreva entre um BEGIN e um END de outra ferramenta. Nem que pareça o lugar lógico. É exatamente esse trecho que será apagado.
  2. Coloque o seu bloco no topo do arquivo, antes do primeiro marcador. Assim ele fica fora dos blocos com dono e roda antes do bloco do WordPress.
  3. Delimite com comentários seus, como # Minhas regras e # Fim das minhas regras. Isso não protege tecnicamente, mas deixa evidente o que é seu quando você ou outra pessoa abrir o arquivo.
  4. Não repita a palavra BEGIN ou END nos seus comentários com o nome de uma ferramenta. Evita que um script confunda o seu bloco com o dele.
  5. Mantenha uma cópia do seu bloco fora do servidor, num arquivo de texto no seu computador. Se algo sumir, você cola de novo.

Depois de salvar, teste o site em uma janela anônima. Se aparecer erro 500, restaure a cópia de segurança como descrito no Passo 2 e revise a sintaxe.

Posição decide se a regra sobreviveRegra entre BEGIN e END0Regra no topo, com com…0
Antes e depois de mover a regra para o topo

Como recuperar uma regra que já sumiu

Se a regra desapareceu e você não tinha backup manual, há três caminhos, do mais rápido ao mais trabalhoso:

  1. Procure cópias antigas na mesma pasta. Alguns plugins e algumas ferramentas salvam versões anteriores com sufixos como .bak ou .old. Com os arquivos ocultos visíveis, eles aparecem na listagem.
  2. Restaure só o .htaccess de um backup. Antes de tudo, copie o .htaccess atual com outro nome, como no Passo 2, porque a restauração pontual costuma gravar no local original e sobrescrever o arquivo que o painel acabou de escrever. A tela Backup nativa do cPanel não restaura arquivo individual. Use Restauração de arquivos e diretórios (File and Directory Restoration), quando a sua hospedagem oferece, ou a restauração de arquivos do JetBackup. Escolha uma data anterior ao sumiço e restaure o .htaccess. Em seguida, no Gerenciador de Arquivos: abra o .htaccess restaurado, copie a sua regra para um arquivo de texto no seu computador, renomeie o restaurado para .htaccess.restaurado e renomeie a cópia que você fez antes de volta para .htaccess. Por fim, cole a regra no arquivo atual.
  3. Reescreva a partir do sintoma. Se não há cópia, anote o que a regra fazia (qual URL redirecionava para onde, qual IP bloqueava) e recrie.

Ao colar de volta, siga o posicionamento da seção anterior. Colar no mesmo lugar de antes faz a regra sumir de novo na próxima vez que você salvar a mesma tela.

Como conferir a regra depois de salvar uma tela do painel

Sempre que salvar uma tela listada na documentação do cPanel sobre .htaccess, ou salvar Links Permanentes no WordPress, abra o .htaccess e confirme que o seu bloco continua no topo e intacto. Leva menos de um minuto e evita descobrir o problema pela queda de um redirecionamento importante.

Quando o .htaccess não é o melhor lugar

Nem toda regra precisa estar escrita à mão. Se o painel tem uma tela para aquilo que você quer fazer, como redirecionar uma URL, mudar a versão do PHP ou proteger uma pasta com senha, usar a tela costuma ser mais seguro que editar manualmente. A tela sabe onde escrever e não briga consigo mesma.

A edição manual vale quando a regra não existe em nenhuma tela: condições combinadas, cabeçalhos específicos, exceções de cache. Nesses casos, o bloco próprio no topo, com backup e conferência após cada alteração, é o caminho.

Se as regras manuais estiverem crescendo e conflitando com plugins com frequência, vale pedir ao suporte da sua hospedagem que revise o arquivo junto com você. Às vezes a solução é remover regras duplicadas, não acrescentar mais uma.

Referências

  1. Documentação oficial (cpanel) — cPanel documentation: .htaccess. Consultado em 2026-11-11.
Leia também