Tutorial - Operações realizáveis com um ficheiro .htaccess

Bases de conhecimento

Tutorial - Operações realizáveis com um ficheiro .htaccess


Icons/System/eye-open Created with Sketch. 387 visualizações 23.05.2023 Web / Alojamento web
Informações sobre a tradução

Esta tradução foi automaticamente gerada pelo nosso parceiro SYSTRAN. Em certos casos, poderão ocorrer formulações imprecisas, como por exemplo nomes de botões ou detalhes técnicos. Recomendamos que consulte a versão inglesa ou francesa do manual, caso tenha alguma dúvida. Se nos quiser ajudar a melhorar esta tradução, clique em "Contribuir" nesta página.

Objetivo

Este tutorial tem como objetivo apresentar as principais funcionalidades do ficheiro ".htaccess" para o seu alojamento Web.

O ficheiro ".htaccess" é um ficheiro de configuração (HTTP) Apache executado pelo servidor Web do seu alojamento Web. Permite definir regras específicas para um diretório e o conjunto dos seus sub-diretórios. Vários ficheiros ".htaccess" podem ser criados no espaço FTP do seu alojamento Web.

Se ainda não existir no seu espaço FTP, pode adicioná-lo criando um ficheiro que designará ".htaccess" no diretório para o qual deseja aplicar uma ou várias das regras descritas neste tutorial.

Para utilizar corretamente o ficheiro ".htaccess", deve conhecer e respeitar as seguintes regras:

  • um único ficheiro ".htaccess" por diretório ou sub-diretório para evitar os conflitos entre diferentes ficheiros ".htaccess";
  • o ficheiro ".htaccess" é invisível para os internautas que visitam o seu website;
  • as regras declaradas num ficheiro ".htaccess" aplicam-se a todo o diretório onde o ficheiro ".htaccess" está instalado, bem como a todos os subdiretórios desse mesmo diretório.

A OVHcloud disponibiliza serviços cuja configuração, gestão e responsabilidade lhe incumbem. Assim, deverá certificar-se de que estes funcionam corretamente.

Este manual fornece as instruções necessárias para realizar as operações mais habituais. No entanto, se encontrar dificuldades, recomendamos que recorra a um fornecedor especializado e/ou que contacte o editor do serviço. Não poderemos proporcionar-lhe assistência técnica. Para mais informações, aceda à secção "Quer saber mais?" deste manual.

Os exemplos que se seguirão serão colocados num ficheiro ".htaccess". Atenção, as regras que define neste ficheiro têm consequências diretas no seu website. Verifique sempre as regras que adicionou antes de as aplicar ao seu website.

Descubra as principais operações que podem ser realizadas com um ficheiro ".htaccess".

Requisitos

Instruções

Autorizar ou restringir o acesso a um diretório ou a um website para um ou vários endereços IP

Esta funcionalidade é muito útil e reforça a segurança dos seus websites. Pode ajudar a reduzir os riscos de pirataria no seu website.

Para mais informações consulte o nosso tutorial: "Como bloquear o acesso ao meu site para alguns endereços IP através de um ficheiro .htaccess? ".

Definir uma password de acesso encriptada para aceder a um diretório ou a um website

Através do ficheiro ".htaccess", pode implementar um acesso protegido (por uma palavra-passe encriptada) aos dados presentes no seu alojamento.

Para mais informações, consulte o nosso tutorial "Proteger a interface de administração do seu site por um ficheiro .htaccess".

Especificar um ficheiro de índice diferente

Por predefinição, o ficheiro index de um diretório é index.html, index.htm ou index.php. Se preferir que seja outro ficheiro, pode adicionar uma linha deste tipo no seu ".htaccess":

DirectoryIndex File_Name

Por exemplo, se deseja utilizar a página receção.html como página de índice, adicione a seguinte linha:

DirectoryIndex linha.html

Impedir a listagem do conteúdo de um diretório

Para impedir que os utilizadores da Internet listem todos os ficheiros contidos num diretório na ausência de ficheiro index (.cgi, .html, .php, etc.), crie um ficheiro ".htaccess" contendo a seguinte linha:

Options -Indexes

Efetuar a re-escritura do URL

Graças ao módulo mod_rewrite do servidor Web HTTP Apache pré-instalado no seu alojamento Web, esta funcionalidade permite reencaminhar:

  • todos os pedidos HTTP para um único ficheiro do seu website;
  • uma parte dos pedidos HTTP para um único ficheiro do seu website;
  • o seu domínio para o seu subdomínio em "www";
  • os pedidos dirigidos a uma pasta específica, sem apresentar a pasta em causa;
  • automaticamente um visitante para o seu website em HTTPS quando o consulta com um URL em HTTP.

Encontre mais informações no nosso tutorial: "Rescrever o URL de acesso ao meu website graças ao mod_rewrite através do ficheiro .htaccess".

Reencaminhar as mensagens de erro

Para personalizar e/ou reencaminhar as suas mensagens de erro para uma página web, crie um ficheiro ".htaccess" contendo a seguinte linha de código:

ErrorDocument Error_Code_Number Message_Or_Destination

Substitua apenas "Error_Code_Number" pelo número do código de erro HTTP Apache correspondente.

Encontre mais informações sobre esta funcionalidade na documentação oficial Apache.

Os códigos de erro HTTP mais comuns são:

  • 401: Authorization required: este erro é gerado quando um visitante introduz um login/palavra-passe incorreto durante o acesso a um ficheiro ou diretório protegido.
  • 403: Access denied: este erro aparece no acesso a um diretório no qual o ficheiro index.html (ou index.cgi, etc.) está ausente e se a configuração do servidor proíbe a visualização dos ficheiros do diretório.
  • 404: Not Found: o ficheiro que o visitante está tentando ver não existe.
  • 500: Internal Server Error: este erro aparece quando um script não foi executado corretamente ou o script ou os direitos do script estão incorretos.

Substitua "Message_Or_Destination" pela ação a efetuar. Para mostrar uma mensagem diretamente, introduza a mensagem correspondente entre aspas. Para reencaminhar para uma página precisa, insira o caminho de acesso a esta página.

Encontre aqui dois exemplos concretos:

  • Deseja indicar "Lamentamos, não tem direito de aceder a este ficheiro" se o visitante encontra um erro 403. Adicione a linha abaixo no ficheiro ".htaccess":
ErrorDocument 403 "Lamentamos, não tem direito de aceder a este ficheiror"
  • Deseja reenviar os erros 404 para a sua página personalizada 404.html (para o seu domínio : domain.tld). Adicione a linha abaixo no ficheiro ".htaccess":
ErrorDocument 404 http://domain.tld/404.html

Também pode reencaminhar um erro para um script Common Gateway IInterface (CGI). Pode codificar um script em CGI para, por exemplo, efetuar as seguintes ações:

  • mostrar uma mensagem;
  • reencaminhar o visitante para outro ficheiro de acordo com o URL inicialmente solicitado (disponível na variável de ambiente REQUEREST_URI);
  • enviar um e-mail.

Por exemplo, para reencaminhar um erro para um script CGI, adicione a seguinte linha no seu ficheiro ".htaccess":

ErrorDocument 404 /cgi-bin/erro.cgi?type=404

A linha acima reencaminha o visitante que encontra um erro 404 para o seu script erro.cgi. O Conselho executará as diretivas nele contidas, especificamente em relação ao erro 404.

Quer saber mais?

Aceder ao espaço FTP do alojamento web

Bloquear o acesso ao meu website para alguns endereços IP através de um ficheiro .htaccess?

Proteger a interface de administração do seu site com um ficheiro .htaccess

Reescrever o URL de acesso ao meu website graças ao mod_rewrite através do ficheiro .htaccess

Para serviços especializados (referenciamento, desenvolvimento, etc), contacte os parceiros OVHcloud.

Se pretender usufruir de uma assistência na utilização e na configuração das suas soluções OVHcloud, consulte as nossas diferentes ofertas de suporte.

Fale com nossa comunidade de utilizadores.