Tutoriel - Opérations réalisables avec un fichier « .htaccess »

Voir en Markdown

Découvrez quelques exemples d'opérations réalisables avec un fichier « .htaccess »

Objectif

Ce tutoriel a pour objectif de vous présenter les principales fonctionnalités du fichier « .htaccess » pour votre hébergement Web.

Le fichier « .htaccess » est un fichier de configuration (HTTP) Apache exécuté par le serveur Web de votre hébergement Web. Il permet de définir des règles spécifiques pour un répertoire et l’ensemble de ses sous-répertoires. Plusieurs fichiers « .htaccess » peuvent être créés dans l’espace FTP de votre hébergement Web.

S’il n’existe pas déjà dans votre espace FTP, vous pouvez l’ajouter en créant un fichier que vous nommerez « .htaccess » dans le répertoire pour lequel vous souhaitez appliquer une ou plusieurs des règles décrites dans ce tutoriel.

Pour utiliser correctement le fichier « .htaccess », vous devez connaître et respecter les règles suivantes :

  • un seul fichier « .htaccess » par répertoire ou sous-répertoire pour éviter les conflits entre différents fichiers « .htaccess » ;
  • le fichier « .htaccess » est invisible pour les internautes qui visitent votre site Web ;
  • les règles déclarées dans un fichier « .htaccess » s’appliquent à l’ensemble du répertoire où le fichier « .htaccess » est installé, ainsi qu’à tous les sous-répertoires de ce même répertoire.
Informations sur l’administration des services OVHcloud et sur la manière d’obtenir l’assistance appropriée

Lors de l’utilisation des guides OVHcloud, veuillez tenir compte des points suivants :

  • Les instructions visent à fournir un maximum de détails, mais ne peuvent pas couvrir tous les cas d’utilisation particuliers. Il peut être nécessaire d’adapter les actions décrites à vos besoins.
  • L’écosystème OVHcloud est conçu pour offrir flexibilité et liberté de choix. Vous êtes donc responsable de la configuration correcte et sécurisée de vos services. Afin d’éviter toute perte de données, nous vous recommandons vivement de mettre en place des stratégies de sauvegarde pour toutes vos données importantes.
  • Nos guides et tutoriels peuvent faire référence à des logiciels ou services tiers utilisés en combinaison avec les solutions OVHcloud. Le support technique fourni par OVHcloud n’inclut pas la configuration de systèmes ou de produits ne relevant pas de notre responsabilité. Cela inclut notamment :
    • Les systèmes d’exploitation et les interfaces utilisateur (Windows, Debian, Plesk, etc.).
    • Tout autre logiciel tiers (clients FTP, logiciels de messagerie, etc.).
    • Les services proposés par d’autres fournisseurs (DNS, API, interfaces utilisateur, etc.).

Pour recevoir l’assistance appropriée en cas de problème, suivez ces recommandations :

  • Vous souhaitez obtenir des conseils personnalisés ou discuter d’un sujet qui n’est pas traité en détail dans notre documentation ?
    Rejoignez la communauté OVHcloud pour y rechercher votre sujet et échanger avec d’autres utilisateurs.
  • Vous devez signaler un incident concernant votre service OVHcloud ou vous rencontrez des difficultés dans l’espace client OVHcloud ?
    Créez une demande d’assistance dans notre centre d’aide.
  • Vous avez besoin d’une assistance professionnelle pour votre projet ou d’aide pour des tâches en dehors de notre périmètre de support ?
    Consultez notre portail des partenaires pour trouver des experts des solutions OVHcloud.
  • Vous recherchez des informations plus détaillées sur nos niveaux de support et Professional Services ?
    Consultez nos pages niveaux de support OVHcloud et OVHcloud Professional Services.

Vous pouvez participer à l’amélioration de notre documentation :

  • Vous souhaitez faire un retour pour améliorer un guide ou signaler des informations insuffisantes sur une page spécifique ?
    Utilisez les boutons « Cette page vous a-t-elle aidé ? » en bas de page pour nous en informer.
  • Vous souhaitez proposer directement une modification de la documentation ?
    Utilisez la fonction « Modifier cette page », disponible en bas de page et dans la barre latérale.

Découvrez les principales opérations réalisables à l’aide d’un fichier « .htaccess ».

Prérequis

En pratique

Autoriser ou restreindre l’accès à un répertoire ou un site Web pour une ou plusieurs adresses IP

Cette fonctionnalité est très utile et renforce la sécurité pour vos sites web. Elle peut contribuer à diminuer les risques de piratage de votre site Web.

Pour plus d’informations, consultez notre tutoriel : « Comment bloquer l’accès à mon site pour certaines adresses IP via un fichier .htaccess ? ».

Définir un mot de passe d’accès chiffré pour accéder à un répertoire ou un site web

Via le fichier « .htaccess », vous pouvez mettre en place un accès protégé (par un mot de passe chiffré) à vos données présentes sur votre hébergement.

Pour plus d’informations, consultez notre tutoriel « Protéger l’interface d’administration de votre site par un fichier .htaccess ».

Spécifier un fichier d’index différent

Par défaut, le fichier index d’un répertoire est index.html, index.htm ou index.php. Si vous préférez que cela soit un autre fichier, vous pouvez ajouter une ligne de ce type dans votre « .htaccess » :

DirectoryIndex File_Name

Par exemple, si vous voulez utiliser la page accueil.html comme page d’index, ajoutez la ligne suivante :

DirectoryIndex accueil.html

Empêcher le listage du contenu d’un répertoire

Pour empêcher les internautes de lister l’ensemble des fichiers contenus dans un répertoire en l’absence de fichier index (.cgi, .html, .php, etc.), créez un fichier « .htaccess » contenant la ligne ci-dessous :

Options -Indexes

Faire de la réécriture d’URL

Grâce au module mod_rewrite du serveur Web HTTP Apache pré-installé sur votre hébergement Web, cette fonctionnalité permet de rediriger :

  • toutes les requêtes HTTP vers un seul fichier de votre site web ;
  • une partie des requêtes HTTP vers un seul fichier de votre site web ;
  • votre nom de domaine vers son sous-domaine en « www » ;
  • les requêtes vers un dossier en particulier, sans afficher le dossier concerné ;
  • automatiquement un visiteur vers votre site web en HTTPS lorsqu’il le consulte avec une URL en HTTP.

Retrouvez plus d’informations dans notre tutoriel : « Réécrire l’URL d’accès à mon site grâce au mod_rewrite via le fichier .htaccess ».

Rediriger les messages d’erreur

Pour personnaliser et/ou rediriger vos messages d’erreurs sur une page web, créez un fichier « .htaccess » contenant la ligne de code suivante :

ErrorDocument Error_Code_Number Message_Or_Destination

Remplacez uniquement "Error_Code_Number" par le numéro du code erreur HTTP Apache correspondant.

Retrouvez plus d’informations sur cette fonctionnalité dans la documentation officielle Apache.

Les codes erreur HTTP les plus courants sont :

  • 401 : Authorization required : cette erreur est générée lorsqu’un visiteur saisit un mauvais login/mot de passe lors de l’accès à un fichier ou répertoire protégé.
  • 403 : Access denied : cette erreur s’affiche lors de l’accès à un répertoire dans lequel le fichier index.html (ou index.cgi, etc.) est absent et si la configuration du serveur interdit l’affichage des fichiers du répertoire.
  • 404 : Not Found : le fichier que le visiteur essaie de voir n’existe pas.
  • 500 : Internal Server Error : cette erreur s’affiche lorsqu’un script ne s’est pas exécuté correctement ou que le script ou les droits du script sont incorrects.

Remplacez "Message_Or_Destination" par l’action à effectuer. Pour afficher un message directement, tapez le message correspondant entre guillemets. Pour rediriger sur une page précise, renseignez le chemin d’accès à cette page.

Retrouvez ci-dessous deux exemples concrets :

  • Vous souhaitez indiquer "Désolé, vous n’avez pas le droit d’accéder à ce fichier" si le visiteur rencontre une erreur 403. Ajoutez la ligne ci-dessous dans votre fichier « .htaccess » :
ErrorDocument 403 "Désolé, vous n'avez pas le droit d'accéder à ce fichier"
  • Vous souhaitez renvoyer les erreurs 404 vers votre page personnalisée 404.html (pour votre domaine : domain.tld). Ajoutez la ligne ci-dessous dans votre fichier « .htaccess » :
ErrorDocument 404 http://domain.tld/404.html

Vous pouvez aussi rediriger une erreur vers un script Common Gateway Interface (CGI). Vous pouvez coder un script en CGI pour, par exemple, effectuer les actions suivantes :

  • afficher un message ;
  • rediriger le visiteur vers un autre fichier selon l’URL demandée initialement (disponible dans la variable d’environnement REQUEST_URI) ;
  • envoyer un e-mail.

Par exemple, pour rediriger une erreur vers un script CGI, rajoutez la ligne suivante dans votre fichier « .htaccess » :

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

La ligne ci-dessus redirigera le visiteur qui rencontre une erreur 404 vers votre script erreur.cgi. Celui-ci exécutera les directives qu’il contient, spécifiquement par rapport à l’erreur 404.

Aller plus loin

Se connecter à l’espace FTP de son hébergement Web

Bloquer l’accès à mon site pour certaines adresses IP via un fichier .htaccess ?

Protéger l’interface d’administration de votre site par un fichier .htaccess

Réécrire l’URL d’accès à mon site grâce au mod_rewrite via le fichier .htaccess

Pour des prestations spécialisées (référencement, développement, etc), contactez les partenaires OVHcloud.

Si vous souhaitez bénéficier d’une assistance à l’usage et à la configuration de vos solutions OVHcloud, nous vous proposons de consulter nos différentes offres de support.

Échangez avec notre communauté d’utilisateurs.

Cette page vous a-t-elle aidé ?