Aller au contenu
Atlas Hoster
Guides

Le fichier .htaccess : à quoi il sert et comment le modifier sans casser son site

Par L'équipe Atlas Hoster7 min de lecture

Vous cherchez à forcer le HTTPS, à changer la page d'accueil de votre site ou à bloquer un robot trop insistant, et toutes les réponses parlent d'un fichier au nom étrange : .htaccess. Ce petit fichier texte donne des consignes au serveur web pour un dossier de votre site. Bien utilisé, il rend de grands services. Mal écrit, une seule ligne suffit à faire tomber le site.

Voici ce qu'il est, où le trouver, les usages les plus courants avec des exemples prêts à copier, et les précautions à prendre avant d'y toucher.

Le .htaccess, c'est quoi ?

Le nom vient de « hypertext access ». C'est un fichier de configuration que lit le serveur web Apache. La documentation d'Apache le décrit comme un fichier de « configuration distribuée » : placé dans un dossier, il applique ses consignes à ce dossier et à tous ses sous-dossiers (documentation Apache).

Son intérêt : modifier le comportement du serveur sans avoir accès à sa configuration principale. C'est exactement la situation d'un hébergement web partagé, où plusieurs sites cohabitent sur le même serveur. Apache cite d'ailleurs les hébergements gérés par un panneau comme cPanel parmi les cas où le .htaccess est la bonne solution.

Nos hébergements web cPanel fonctionnent avec Apache : le .htaccess de votre site y est donc lu à chaque visite.

Où le trouver et comment le modifier

Le fichier principal se trouve à la racine de votre site, dans le dossier public_html. Comme son nom commence par un point, il est caché : beaucoup d'outils ne l'affichent pas par défaut.

Dans cPanel, ouvrez le Gestionnaire de fichiers (rubrique Fichiers), cliquez sur Paramètres en haut à droite et cochez l'option qui affiche les fichiers cachés. Le fichier apparaît alors dans public_html ; sélectionnez-le puis cliquez sur Éditer. Notre article d'aide Publier votre site avec le Gestionnaire de fichiers présente cet outil. Vous pouvez aussi passer par un client FTP qui affiche les fichiers cachés.

S'il n'existe pas, vous pouvez le créer : un simple fichier texte nommé exactement .htaccess, sans extension.

Avant toute modification, faites une copie du fichier (par exemple .htaccess.bak), ou téléchargez-le sur votre ordinateur. C'est votre retour arrière.

Rediriger tout le site vers HTTPS

C'est l'usage le plus demandé. Une fois votre certificat SSL en place, ces trois lignes envoient chaque visite en http:// vers la même adresse en https://, avec une redirection permanente (301) :

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Placez-les en haut du fichier. Deux remarques :

  • les versions récentes de cPanel proposent aussi une option de redirection HTTPS forcée par domaine dans l'écran Domaines, qui évite d'écrire la règle à la main (documentation cPanel sur les redirections) ;
  • si votre site passe par un proxy ou un CDN qui contacte votre serveur en HTTP, cette règle peut tourner en boucle. Dans ce cas, réglez la redirection au niveau du proxy.

Pourquoi c'est important pour la confiance et le référencement : voir notre article Passer en HTTPS.

Rediriger une page ou un domaine

Pour une ancienne page qui a changé d'adresse, une ligne suffit :

Redirect 301 /ancienne-page.html https://www.exemple.com/nouvelle-page/

Le plus simple reste souvent l'outil Redirections de cPanel, qui écrit la règle pour vous dans le .htaccess. Il est décrit pas à pas dans l'article d'aide Rediriger une page ou un domaine vers une autre adresse. La documentation de cPanel précise que l'outil ajoute ses règles à la fin du fichier, et que certaines applications comme WordPress peuvent alors les ignorer : si une redirection ne fonctionne pas sur un site WordPress, c'est la première piste.

Changer la page d'accueil

Par défaut, le serveur affiche le fichier index.html ou index.php quand on ouvre votre domaine. Pour en choisir un autre, utilisez la directive DirectoryIndex (documentation Apache, mod_dir) :

DirectoryIndex accueil.html index.php

Le serveur essaie les fichiers dans l'ordre : accueil.html s'il existe, sinon index.php. Si vous voulez seulement remplacer la page d'accueil, renommer votre fichier en index.html reste la solution la plus simple (Publier votre site web : où mettre vos fichiers).

Bloquer une adresse IP ou un robot

Pour refuser l'accès à une adresse ou à une plage d'adresses, la syntaxe d'Apache 2.4 est la suivante (contrôle d'accès, documentation Apache) :

<RequireAll>
    Require all granted
    Require not ip 203.0.113.45
    Require not ip 198.51.100.0/24
</RequireAll>

Les adresses ci-dessus sont des exemples réservés à la documentation : remplacez-les par celles que vous voulez bloquer. L'outil Bloqueur d'adresses IP de cPanel fait la même chose sans écrire de code : il découpe les plages en sous-réseaux et les ajoute lui-même au .htaccess (documentation cPanel). Voir Bloquer une adresse IP ou un domaine.

Ne bloquez jamais votre propre adresse, et méfiez-vous des grandes plages : une adresse est souvent partagée par beaucoup de monde.

Protéger un dossier par mot de passe

Un dossier réservé (une préproduction, des documents pour un client) peut demander un identifiant et un mot de passe. Le principe repose sur deux fichiers : le .htaccess, qui exige une connexion, et un fichier .htpasswd, qui contient les mots de passe chiffrés.

L'outil Confidentialité du répertoire de cPanel crée les deux pour vous et range le fichier de mots de passe hors du dossier public (documentation cPanel, support cPanel). La marche à suivre est dans l'article d'aide Protéger un dossier de votre site par un mot de passe. Utilisez cette protection avec HTTPS, sinon le mot de passe circule en clair.

Afficher une page d'erreur personnalisée

Plutôt que la page 404 brute du serveur, vous pouvez afficher une page à votre image, avec un lien vers l'accueil :

ErrorDocument 404 /erreur-404.html

Créez d'abord le fichier erreur-404.html à la racine du site.

Les précautions à prendre

Une erreur de syntaxe casse tout le dossier. Une directive mal écrite ou non autorisée provoque une erreur serveur (souvent « 500 Internal Server Error ») sur le dossier et ses sous-dossiers. La documentation d'Apache conseille alors de lire le journal d'erreurs, qui nomme la directive en cause. Le réflexe le plus rapide : remettre la copie que vous avez faite, puis réessayer une modification à la fois.

Ne touchez pas aux blocs écrits par vos logiciels. WordPress gère ses propres règles entre les lignes # BEGIN WordPress et # END WordPress, et peut réécrire ce passage (documentation WordPress). cPanel ajoute un bloc marqué cPanel-generated handler, do not edit, qui fixe la version de PHP de votre site (support cPanel). Écrivez vos règles en dehors de ces blocs.

Testez en navigation privée. Les navigateurs gardent en mémoire les redirections permanentes : une ancienne règle peut sembler encore active alors qu'elle ne l'est plus.

Un dossier, un fichier. Un .htaccess placé dans un sous-dossier s'ajoute à celui de la racine. Si une règle vous surprend, vérifiez qu'un autre fichier plus bas dans l'arborescence ne la contredit pas.

Si votre site affiche une erreur après une modification et que vous ne trouvez pas la cause, notre article Site en panne : la marche à suivre vous aide à garder la tête froide, et une sauvegarde de votre site avant de grosses modifications reste la meilleure assurance.

Chez Atlas Hoster

Nos offres d'hébergement web fonctionnent avec cPanel et Apache : vous gérez votre .htaccess vous-même, avec le Gestionnaire de fichiers ou par FTP, et les outils de cPanel (Redirections, Bloqueur d'adresses IP, Confidentialité du répertoire) écrivent les règles courantes à votre place. Pour la sécurité de votre site au-delà du .htaccess, voyez aussi notre page Sécurité et l'article Sécuriser un site WordPress.

Questions fréquentes

Je ne vois pas le fichier .htaccess, est-ce normal ?

Oui. Son nom commence par un point, il est donc caché. Dans le Gestionnaire de fichiers de cPanel, ouvrez les Paramètres et affichez les fichiers cachés. S'il n'existe toujours pas, vous pouvez le créer.

Mon site affiche une erreur 500 après avoir modifié le .htaccess. Que faire ?

Remettez la copie que vous aviez faite avant la modification, ou retirez les dernières lignes ajoutées : si l'erreur venait de là, le site s'affiche de nouveau. Reprenez ensuite la modification ligne par ligne pour trouver celle qui pose problème.

Faut-il un .htaccess dans chaque dossier ?

Non. Le fichier placé dans public_html s'applique à tout le site. Un .htaccess dans un sous-dossier ne sert qu'à ajouter ou changer des règles pour ce dossier.

Le .htaccess fonctionne-t-il sur tous les serveurs ?

Non, c'est un fichier propre à Apache (et aux serveurs compatibles). Nginx, par exemple, ne le lit pas : sur un VPS sous Nginx, les mêmes règles s'écrivent dans la configuration du serveur.

Sources

Tous les articles

Une question sur votre infrastructure ?

Décrivez-nous votre projet : un ingénieur vous répond et vous propose l'offre qui lui convient.