Sobre ficheiros .htaccess
O que é um ficheiro .htaccess?
Um ficheiro .htaccess é um ficheiro de configuração lido pelos servidores Web Apache, colocado num diretório para controlar a forma como os pedidos a esse diretório e a tudo o que se encontra abaixo dele são processados. É assim que a maioria dos serviços de alojamento partilhado permite aos proprietários de sites alterar o comportamento do servidor sem acesso à configuração principal do servidor.
Lida com redirecionamentos, força o HTTPS, define páginas de erro personalizadas, controla a colocação em cache e a compressão, restringe o acesso por endereço e reescreve URLs em formatos legíveis. É por isso que um gerador de htaccess é útil: a sintaxe é concisa, pouco tolerante a erros e partilhada por vários módulos Apache não relacionados, pelo que a regra de que precisa raramente é a regra de que se lembra.
Aplica-se apenas ao Apache e a servidores compatíveis, como o LiteSpeed. No Nginx, as regras equivalentes encontram-se na configuração do servidor, e um ficheiro .htaccess é simplesmente ignorado.
O .htaccess ainda é relevante em 2026?
No alojamento Apache, continua a ser a principal ferramenta ao dispor do proprietário de um site, e as tarefas que trata são as que mais visivelmente podem danificar sites: redirecionamentos após uma migração, forçar HTTPS e apresentar uma página adequada quando algo está em falta.
No entanto, a sua utilização diminuiu. A compressão e a colocação em cache são cada vez mais tratadas por uma CDN à frente do servidor, e as plataformas baseadas em Nginx ou em alojamento gerido disponibilizam frequentemente estas definições num painel de controlo.
Quando ainda estiver a ser utilizado, trate-o com cuidado. É lido em cada pedido, pelo que acarreta um pequeno custo de desempenho, e um erro de sintaxe não permite uma degradação controlada do site. Devolve um erro 500 para todas as páginas de uma só vez.
Para que é normalmente utilizado o .htaccess
- Redirecionar URLs antigas para novas com um redirecionamento permanente 301 após uma reestruturação.
- Forçar HTTPS para que a versão insegura de uma página nunca seja servida.
- Escolher um nome de anfitrião canónico, para que as versões com e sem www não sejam ambas resolvidas.
- Apresentar páginas 404 e 500 personalizadas em vez da página predefinida do servidor.
- Definir cabeçalhos de cache e ativar a compressão quando nenhuma CDN trata disso.
- Restringir o acesso a caminhos de administração ou ambientes de pré-produção por endereço IP.
Erros comuns
- Editar o ficheiro em produção sem uma cópia de segurança. Um único erro de digitação pode deixar o site inteiro indisponível.
- Encadear redirecionamentos em vez de apontar cada URL antiga diretamente para o seu destino final.
- Redirecionar tudo o que foi removido para a página inicial, o que não ajuda nem os visitantes nem os motores de pesquisa.
- Usar um redirecionamento temporário 302 para uma mudança permanente, impedindo que os sinais de classificação sejam transferidos.
- Bloquear agentes de utilizador de forma tão abrangente que os crawlers legítimos sejam bloqueados juntamente com os scrapers.
Utilizar o gerador de htaccess
Selecione os comportamentos de que precisa, preencha os detalhes e o gerador de htaccess reúne as diretivas corretamente formatadas para colar no seu ficheiro. Remove o problema de sintaxe, que é a origem da maioria dos erros.
Há dois hábitos que vale sempre a pena manter. Transfira sempre uma cópia do ficheiro existente antes de o substituir, para poder reverter a alteração em poucos segundos, em vez de depender da memória. E carregue o site imediatamente depois de guardar, porque, se o ficheiro estiver malformado, vai querer descobrir isso agora e não através de um cliente.
Próximos passos
A maior parte do que um ficheiro .htaccess controla merece ser verificada posteriormente. Verifique o
código de estado devolvido pelo URL redirecionado, confirme se o
redirecionamento HTTPS está a funcionar e certifique-se de que a
compressão está ativada, caso a tenha configurado aqui.