O que é o arquivo .htaccess do WordPress e para que serve?

Atualizado em 12 de noviembre de 2023

WordPress é uma das plataformas mais versáteis para a construção de um site porque você tem total controle sobre sua instalação e configuração. Um dos arquivos que oferece esse controle no WordPress é o arquivo .htaccess.

É um arquivo de configuração que permite ver como seu servidor. E, dependendo do seu ambiente de hospedagem, ele pode ser usado para alterar uma variedade de recursos na instalação do WordPress.

Saber o que você pode ou não fazer com o arquivo é muito útil, e hoje irei abordar tudo o que você precisa saber sobre o arquivo .htaccess no WordPress.

Qual é a função do arquivo .htaccess no WordPress?

O arquivo .htaccess é um arquivo de configuração no WordPress usado para ativar ou desativar recursos em sua instalação, fazer alterações na configuração por diretório e é o arquivo padrão que o WordPress usa para redirecionamentos e estruturas de links permanentes.

O arquivo geralmente está localizado no diretório raiz do seu site. No entanto, às vezes o WordPress pode não gerar nenhum arquivo .htaccess. Nesses casos, o usuário deverá criar um manualmente.

Também é importante notar que muitos plugins usarão o arquivo .htaccess para funcionar corretamente. Plugins de cache e segurança são os mais comuns, mas qualquer plugin pode usar .htaccess.

Alguns dos principais usos do arquivo .htaccess incluem:

Redirecionar usuários para uma página de erro personalizada

Existem muitos erros comuns do WordPress que você encontrará ao executar um site. Esses erros são muito inconvenientes e podem prejudicar o seu SEO. Você pode mitigar os efeitos redirecionando os visitantes para uma página de erro personalizada.

Claro, isso também pode ser usado para redirecionamentos gerais. Muitos plug-ins de redirecionamento gravam diretamente no arquivo .htaccess.

Decida qual arquivo usar como arquivo de índice

Por padrão, quando os visitantes acessam seu site, eles encontrarão algo semelhante a www.ggsexample1.com/index.html ou www.ggsexample1.com/index.php. Na verdade, você pode alterar qual arquivo atuará como índice dentro do arquivo .htaccess.

Você não apenas pode alterar esse arquivo, mas também excluí-lo completamente, que é o que a maioria dos principais sites faz.

Proteja arquivos com senha

A segurança é uma grande preocupação para todos os sites, e uma maneira de melhorá-la é proteger seus arquivos com senha. Isso garante que apenas as pessoas que deveriam acessar um arquivo possam fazê-lo. Você pode fazer isso através do cPanel, mas é muito mais rápido fazer isso através do .htaccess.

Isso garante que apenas usuários com as informações necessárias poderão fazer alterações nesses arquivos.

cache

O cache pode ajudar a acelerar o seu site, removendo arquivos temporários que retardam a experiência. Na verdade, você pode limpar o cache do arquivo .htaccess, mas considere usar um plug-in de cache para obter melhores resultados.

Você também pode definir temporizadores de expiração para conteúdo em cache. Isso ajudará a garantir que ele seja removido somente após um determinado período de tempo.

Quando você ouve alguém mencionar “aproveitar o cache do navegador”, um dos métodos é por meio de .htaccess.

Restringir o acesso ao seu site

Também é possível bloquear o acesso de endereços IP específicos ao seu site. Na verdade, você pode dar um passo além e bloquear países específicos. Esta é uma ótima tática para ajudar a reduzir os spambots.

Também pode ser útil se você não quiser lidar com conformidade. GDPR mas não é uma solução completa.

Como criar e editar com segurança .htaccess no WordPress

Agora que sabemos o que é o arquivo .htaccess e onde ele está localizado, é hora de começar a falar sobre como editá-lo. Porém, como o arquivo pode não existir atualmente, precisamos saber como gerá-lo.

Felizmente, isso é muito fácil de fazer.

Como gerar o arquivo .htaccess no WordPress

Existem várias maneiras de gerar um arquivo .htaccess no WordPress, e nenhuma delas é muito complicada.

De longe, o método mais fácil de gerar o arquivo .htaccess é simplesmente atualizar as configurações da estrutura do link permanente no WordPress. E para ser claro, isso não exige que você os altere.

Para fazer isso, clique em Configurações e selecione a opção Links permanentes no WordPress.

Clique em Configurações e selecione Links permanentes

Aqui você encontrará todas as opções para personalizar a estrutura do link permanente do seu site. Você não precisa alterar nada nesta página.

Na verdade, certifique-se não mude nada aqui, pois pode atrapalhar seriamente a classificação de SEO do seu site e quebrar todos os links internos e externos ao seu conteúdo.

Basta rolar para baixo e clicar no botão “Salvar alterações”.

Salve as alterações para gerar um arquivo .htaccess no WordPress

E isso é. Agora você deve ter gerado um arquivo .htaccess. Caso contrário, é um bom indicador de que o arquivo já existe e está oculto.

Como editar o arquivo .htaccess

Agora que você tem o arquivo .htaccess instalado, pode começar a editar. Como a maioria das coisas no WordPress, existem várias maneiras de fazer isso, sendo as duas principais usando um plugin ou editando diretamente o arquivo.

Usar um plugin permite que você edite o arquivo sem precisar fazer login no cPanel. Portanto, muitos desenvolvedores preferem porque você pode fazer tudo no site.

No entanto, muitos também gostam de evitar a instalação de plugins desnecessários.

Usando o plug-in do editor de arquivos Htaccess

O plugin Htaccess File Editor é realmente o melhor plugin para editar com segurança o arquivo .htaccess do WordPress.

Ao contrário de editar diretamente o arquivo no diretório de arquivos via cPanel ou FTP, este plugin irá verificar automaticamente seu arquivo .htaccess e procurar erros de sintaxe que possam causar um erro fatal.

Além disso, o plugin gera automaticamente um backup do seu site sempre que você edita o arquivo. Isso garante que, se você não detectar um erro, ainda poderá restaurar seu site facilmente em minutos.

Felizmente, começar a usar o plugin é muito simples, então vamos começar.

Observação: Se você é novo em codificação, é importante entender a diferença entre um erro de sintaxe e um erro lógico. Um erro de sintaxe ocorre quando você digita algo incorretamente ou esquece o ponto e vírgula. Um erro lógico ocorre quando o que você escreve está correto, mas faz algo diferente do pretendido. Este plug-in apenas detectará erros de sintaxe.

Etapa 1: instalando o editor de arquivos Htaccess

Vamos começar clicando em Plugins e selecionando a opção Adicionar Novo no painel de administração esquerdo.

Adicionar novo

Procure por Editor Htaccess na caixa de pesquisa disponível. Isso abrirá plug-ins adicionais que podem ser úteis.

Editor Htaccess

Role para baixo até encontrar o plugin Htaccess Editor da WebFactory LTD. Clique no botão “Instalar agora” e ative-o para uso.

instale agora

Antes de prosseguir, é muito importante falar sobre os perigos de bagunçar o arquivo .htaccess. Fazer isso pode deixar seu site completamente offline e você não conseguirá acessar seu conteúdo.

Você saberá que é um erro .htaccess se vir o erro 500 ou uma tela em branco.

Se isso acontecer, você precisará usar um cliente FTP para fazer upload de um backup do seu arquivo .htaccess ou excluí-lo completamente. Esta pode ser uma experiência muito frustrante se você for novo no WordPress.

Portanto, só recomendo editar o arquivo .htaccess se você tiver o conhecimento adequado.

Etapa 2: use o plug-in do editor de arquivos Htaccess

No painel de administração esquerdo, clique em Configurações e selecione a opção WP Htaccess Editor.

WP Htaccess

A primeira coisa que você deve ver é a seção “Leia com atenção antes de continuar”.

Isto descreve o que fazer se você não editar o arquivo corretamente. Eu recomendo fortemente copiar tudo nesta seção e colá-lo em um bloco de notas ou documento do Word. Se você cometer um erro, não conseguirá acessar seu site para lê-lo.

Abaixo desta seção, você verá uma caixa vermelha avisando sobre a edição do arquivo .htaccess. Também informa que um backup é criado quando você faz uma alteração.

Clique no botão “Eu entendo. Habilite o editor.” botão.

Eu entendo

Agora você terá acesso total para editar seu arquivo Htaccess.

Etapa 3: verifique se há erros e salve as alterações

Na parte inferior, você notará três botões. Isso inclui os botões Salvar alterações, Testar antes de salvar e Restaurar o último backup.

Botões

Sempre clique no botão Testar antes de salvar primeiro. Isso verificará se há erros de sintaxe.

Se algo não estiver funcionando corretamente após fazer uma alteração e você não encontrar o erro 500, poderá usar o botão Restaurar último backup para corrigir o problema.

Parabéns por aprender como editar com segurança seu arquivo .htaccess no WordPress com o plugin Htaccess File Editor.

Como criar e editar .htaccess no cPanel

A abordagem mais direta para criar e editar o arquivo .htaccess é fazê-lo manualmente no cPanel. Esta é tradicionalmente a forma mais comum de editar arquivos no WordPress.

Tem a clara vantagem de não necessitar de plugin. Portanto, muitos desenvolvedores preferem este método.

Carregar manualmente um arquivo .htaccess para cPanel

O segundo método é mais direto, pois envolve você mesmo fazer o upload do arquivo .htaccess. Agora, eu sei o que você está pensando, eu realmente preciso escrever o arquivo inteiro para fazer upload?

Não. Em vez disso, você pode criar um arquivo em branco chamado .htaccess e carregue-o no diretório raiz do seu site.

Para fazer isso, abra um programa como o Bloco de Notas (na verdade, qualquer processador de texto serve) e salve o documento como .htaccess. Você também pode usar esse tempo para inserir qualquer um dos códigos que deseja incluir no arquivo.

Quando o arquivo estiver pronto, faça login em sua conta. hospedagem e acesse o cPanel. Clique na opção Gerenciador de arquivos.

Clique em Gerenciador de arquivos

Localize e insira o diretório raiz do seu site. Geralmente é chamado de public_html, mas o nome pode variar. Uma vez dentro, clique na opção “Upload” para iniciar o upload do seu arquivo.

Selecione a opção Carregar

Isso abrirá uma nova guia no seu navegador. Você pode arrastar e l arquivo na caixa ou use o botão “Selecionar arquivo” para selecionar o arquivo que deseja enviar. O arquivo será adicionado ao seu diretório atual.

Edição manual do arquivo .htaccess no WordPress

Como todos os arquivos no WordPress, você pode editar manualmente o arquivo usando seu cPanel. A principal diferença com o método de plug-in é que os plug-ins tendem a oferecer salvaguardas adicionais que podem protegê-lo contra erros.

Eles não estão presentes ao editar diretamente o código em um arquivo, então você precisa ter certeza de que o que digitou está correto.

Etapa 1: Encontre o arquivo .htaccess

Faça login no seu cPanel e acesse o Gerenciador de Arquivos.

Clique em Gerenciador de arquivos

Entre no diretório public_html, localize o arquivo .htaccess e clique com o botão direito sobre ele para selecionar a opção Editar. Para usuários de Mac, CMD+Click abrirá esta janela suspensa.

Edite o arquivo .htaccess no WordPress

Uma pequena janela pop-up aparecerá explicando os perigos da edição direta de arquivos. É altamente recomendável criar um backup atualizado antes de fazer alterações em um arquivo.

Isso garante que, se algo der errado, você poderá usá-lo para restaurar seu site. Isso ajuda a evitar tempo de inatividade ou simplesmente desfazer alterações indesejadas.

Passo 2 – Edite o arquivo

O .htaccess pode estar em branco se você o carregou recentemente. Caso contrário, você deverá ver algum código padrão. Sempre que você modificar o arquivo .htaccess, ou qualquer arquivo em geral, é importante não inserir código em uma função.

Uma função é uma seção de código que executa uma tarefa específica ou adiciona um recurso. Qualquer código adicionado não deve estar dentro de uma função, caso contrário, ocorrerá um erro.

A boa notícia é que você pode encontrar muitos códigos online para fazer alterações simples no arquivo .htaccess.

Basta inserir o código no arquivo.

Etapa 3: salvar as alterações

Ao terminar de editar o arquivo, você deve verificar imediatamente tudo o que inseriu. Esta é a melhor maneira de evitar erros.

Fique atento a erros de sintaxe e tente reproduzir o código em sua cabeça.

Quando estiver completamente satisfeito, clique no botão “Salvar alterações” no canto superior direito.

Salve as alterações em seu arquivo .htaccess no WordPress

E isso é. Você pode verificar o site deles para ter certeza de que nenhum erro ocorreu. Caso contrário, parabéns, você editou com sucesso o arquivo .htaccess. Se houve erros, verifique o código que você adicionou.

Perguntas frequentes sobre arquivos .htaccess do WordPress

Alguma vez preciso editar o arquivo .htaccess no WordPress?

É perfeitamente possível nunca mexer no arquivo .htaccess no WordPress.

De modo geral, quase tudo que você pode fazer no arquivo .htaccess pode ser feito em outro arquivo, ou você pode usar um plugin que gravará no próprio arquivo, como um plugin de cache ou redirecionamento.

Em geral, os usuários que não têm muita experiência em codificação devem tentar evitar a codificação manual de arquivos sempre que possível. Erros simples podem resultar em tempo de inatividade, por isso sempre recomendo a todos os proprietários de sites que aprendam o básico da codificação.

Posso usar o editor de arquivos de tema para editar o arquivo .htaccess?

Não.

Como o nome sugere, o Theme File Editor só permite ao usuário editar arquivos dentro do tema WordPress atualmente selecionado. O arquivo .htaccess está localizado no diretório raiz do seu site e não no tema em si.

A única maneira de editar este arquivo no WordPress é usar um plugin. E, felizmente, não falta.

Existem outros plug-ins que podem ajudar?

Absolutamente!

Existem vários plug-ins que permitem editar diretamente o arquivo .htaccess no WordPress. No entanto, embora alguns deles sejam claramente rotulados para essa finalidade, muitos plug-ins têm isso como um recurso, como Yoast SEO .

Aqui estão mais alguns que posso recomendar:

Controle de acesso WP Ht

Controle de acesso WP Ht

O plugin WP Htaccess Control não está realmente no diretório de plugins do WordPress, mas ainda é totalmente gratuito. Ele fornecerá uma interface para personalizar o arquivo .htaccess gerado pelo WordPress.

Você também terá acesso aos seus links permanentes (autor, categoria, arquivos, paginação e taxonomias personalizadas). Existem muitas opções de personalização disponíveis, então dê uma olhada para ver se é certo para você.

Editor de arquivos Htaccess

Editor de arquivos Htaccess

Htaccess File Editor é outro ótimo plugin para usar se você precisar editar o arquivo .htaccess no WordPress. O plugin permite editar o arquivo sem precisar usar FTP. Simples assim.

Possui alguns recursos úteis, como criar um backup do arquivo .htaccess. Dessa forma, se você fizer uma alteração que dê errado, poderá restaurar o arquivo como estava antes de fazer a alteração.

Yoast SEO

Yoast SEO

Você provavelmente já tem o Yoast SEO instalado em seu site. Caso contrário, você realmente deveria instalá-lo hoje. É uma das melhores ferramentas SEO para WordPress e também permite editar o arquivo .htaccess.

Yoast oferece um ótimo editor de arquivos que pode editar arquivos .htaccess e muitos outros. Infelizmente, a maioria das pessoas que o têm instalado talvez nem saiba que esse é um recurso.

O arquivo .htpasswd está relacionado ao arquivo .htaccess?

Mais ou menos.

É possível proteger seus diretórios com senha usando o arquivo .htaccess. O arquivo .htpasswd é necessário para que isso funcione, pois é o arquivo onde a senha está armazenada.

Dito isto, você realmente não precisa usar o arquivo .htaccess. Assim, enquanto houver conexão, são arquivos únicos.

O arquivo .htaccess pode ajudá-lo a melhorar seu site

Embora você possa criar um site de sucesso sem precisar editar o arquivo .htaccess diretamente, seria uma coisa muito estranha de se fazer. Felizmente, é muito fácil fazer alterações no arquivo e há muitos recursos.

Mesmo que você não seja um especialista em codificação, poderá encontrar códigos online que podem ser copiados e colados diretamente no arquivo. Isso reduz significativamente a dificuldade, mas sempre tenha cuidado ao usar o código encontrado online.

De qualquer forma, agora você deve ter um ótimo entendimento de como criar e editar com segurança o arquivo .htaccess no WordPress ou cPanel. Portanto, certifique-se de aproveitar isso.

Scroll al inicio