O que é o .htaccess
O .htaccess é um arquivo de texto com regras de configuração do servidor web Apache. Ele vale para a pasta onde está e para todas as subpastas. O nome começa com ponto, então em muitos programas ele fica oculto: no Gerenciador de Arquivos do Plesk ou no cliente de FTP, ative a opção de mostrar arquivos ocultos.
Ele existe para permitir ajustes sem mexer na configuração principal do servidor. Cada site pode ter as próprias regras, e o Apache lê o arquivo a cada acesso, sem precisar reiniciar nada.
Para que serve
- Links amigáveis: o WordPress usa o .htaccess para transformar endereços como
?p=123em/nome-do-post/. - Redirecionamentos: levar uma página antiga para a nova, ou forçar HTTPS.
- Segurança: bloquear o acesso a arquivos sensíveis, a pastas ou a endereços IP.
- Desempenho: definir por quanto tempo o navegador guarda imagens, CSS e JavaScript.
- Páginas de erro: indicar páginas próprias para erros 404 e 500.
Onde fica o arquivo
Na hospedagem da Appuni, o .htaccess principal fica na pasta raiz do site, normalmente httpdocs. Se ele não existir, você pode criar um arquivo novo com esse nome exato. No WordPress, o próprio sistema cria o arquivo quando você salva os links permanentes.
O .htaccess padrão do WordPress
Este é o bloco que o WordPress grava. Se o arquivo for apagado, as páginas internas passam a dar erro 404:
# 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 WordPressNão escreva nada entre # BEGIN WordPress e # END WordPress: o WordPress reescreve esse trecho e apaga o que estiver ali. Coloque as suas regras antes ou depois do bloco.
Exemplos úteis
Forçar HTTPS
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]No Plesk existe uma opção mais simples para isso: em Hospedagem e DNS > Hospedagem, marque o redirecionamento permanente de HTTP para HTTPS.
Redirecionar uma página antiga
Redirect 301 /pagina-antiga/ https://www.seudominio.com.br/pagina-nova/Bloquear o xmlrpc.php do WordPress
<Files xmlrpc.php>
Require all denied
</Files>Só bloqueie se você não usa o aplicativo do WordPress, o Jetpack ou integrações que dependem desse arquivo.
Cache de arquivos estáticos no navegador
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType image/webp "access plus 1 year"
ExpiresByType image/jpeg "access plus 1 year"
ExpiresByType text/css "access plus 1 month"
ExpiresByType application/javascript "access plus 1 month"
</IfModule>E quando o site usa Nginx?
O Nginx não lê o .htaccess. Nos servidores Plesk, o Nginx normalmente fica na frente do Apache: ele entrega os arquivos estáticos e repassa o resto para o Apache, que segue lendo o .htaccess. Se a opção de servir arquivos estáticos direto pelo Nginx estiver ligada, regras do .htaccess para imagens, CSS e JavaScript podem não ser aplicadas. Nesses casos, as regras vão nas diretivas adicionais do Nginx, em Configurações do Apache e nginx.
Cuidados ao editar
- Faça uma cópia do arquivo antes de qualquer mudança.
- Um erro de digitação derruba o site com erro 500. Se isso acontecer, volte a cópia.
- Edite em texto puro, sem formatação. Use o editor do Plesk ou um editor de código.
- Evite regras repetidas por plugins diferentes, como dois plugins de cache gravando no mesmo arquivo.
Perguntas frequentes
O site deu erro 500 depois que mexi no .htaccess. O que faço?
Restaure a cópia que você fez antes da alteração ou renomeie o arquivo para .htaccess-old. Se for WordPress, depois salve os links permanentes de novo para recriar o bloco padrão.
Posso ter mais de um .htaccess?
Sim. Cada pasta pode ter o seu, e as regras valem para aquela pasta e as de dentro. É comum ter um na raiz e outro para proteger uma pasta específica.
