Revisão técnica: 08/09/2026. O .htaccess permite configurar certos comportamentos por diretório em servidores Apache que autorizam seu uso. Ele não é um arquivo universal de hospedagem: suporte, diretivas permitidas e módulos dependem do ambiente.
Antes de editar
Identifique a raiz pública do domínio e habilite a exibição de arquivos ocultos no gerenciador. Faça uma cópia da configuração existente em local privado. No WordPress, preserve os blocos gerenciados pelo CMS e por plugins; alterações dentro deles podem ser substituídas posteriormente.
A configuração principal define o que pode ser alterado com AllowOverride e AllowOverrideList. Quando você administra o servidor, centralizar as regras na configuração principal pode ser preferível. Em hospedagem compartilhada, confirme as opções disponíveis com o suporte.
Entenda sintaxe e herança
Um .htaccess pode afetar seu diretório e os descendentes. Outro arquivo em uma subpasta não apaga automaticamente todas as regras anteriores: a combinação depende das diretivas e dos módulos envolvidos. Evite reunir receitas desconexas em um único arquivo.
Use texto simples, aspas comuns e comentários em linhas iniciadas por #. Comentários com //, aspas tipográficas e diretivas indisponíveis podem provocar erro. Altere uma finalidade por vez para conseguir identificar a causa de uma falha.
Exemplo: desativar listagem automática
# Requer permissao para alterar esta opcao
Options -IndexesEssa opção desativa a listagem automática do diretório quando não há um índice aplicável. Ela não bloqueia o download de um arquivo cujo caminho é conhecido. Usar IndexIgnore ou criar um index vazio também não transforma arquivos públicos em privados.
Confira o resultado e saiba reverter
Teste a função alterada, a página inicial, uma página interna e seus recursos. Ao encontrar erro 500, consulte o log e restaure a cópia anterior. Regras de redirecionamento exigem conferir destino e ausência de ciclos; regras de acesso exigem testar visitantes permitidos e bloqueados.
Continue pelos guias de proteção de arquivos, hotlink e páginas de erro. Referência: tutorial oficial de .htaccess.
