# 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.

> 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.

João Rizzon · 2026-11-12 · Painéis

---

## 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](https://docs.cpanel.net/tags/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

- No cPanel, abra **Gerenciador de Arquivos** (seção Arquivos).
- Clique em **Configurações**, no canto superior direito.
- 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

- Entre em `public_html` (ou na pasta raiz do domínio, se for um domínio adicional).
- Clique com o botão direito em `.htaccess` e escolha **Copiar**.
- 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:

- `RewriteEngine On` liga o mecanismo de reescrita de URLs.
- `RewriteCond %{HTTP_HOST} ^www\.exemplo\.com\.br$ [NC]` é a condição: a regra seguinte só roda se o visitante pediu `www.exemplo.com.br`. O `[NC]` ignora maiúsculas e minúsculas, e a barra antes de cada ponto faz o ponto valer como ponto literal.
- `RewriteRule ^(.*)$ https://exemplo.com.br/$1 [R=301,L]` envia o visitante para o mesmo caminho sem www e com HTTPS. O `$1` repete o caminho original, `R=301` avisa navegadores e buscadores que a mudança é permanente, e `L` encerra o processamento ali.

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.

## 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:

- **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.
- **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.
- **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.
- **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.
- **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.

## 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:

- **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.
- **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.
- **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](https://docs.cpanel.net/tags/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.

