📁 .htaccess

Placé à la racine de votre hébergement web, le fichier .htaccess est un fichier de configuration décentralisé propre aux serveurs web Apache et LiteSpeed. Dans l’écosystème WordPress, son rôle est fondamental : c’est lui qui intercepte chaque requête entrante pour la traduire en URL sémantique propre et compréhensible. Sans ce fichier, le système de permaliens de WordPress ne peut pas fonctionner, et vos articles ou pages renvoient immédiatement des erreurs 404.

Au-delà du routage d’URL généré par les réglages WordPress, le fichier .htaccess est également un levier puissant pour gérer les redirections 301, forcer le protocole sécurisé HTTPS et verrouiller les fichiers sensibles de votre installation.

Sommaire

Rôle et emplacement du fichier .htaccess

Le fichier .htaccess (pour Hypertext Access) réside au premier niveau de votre projet, au même emplacement que le fichier wp-config.php et le dossier wp-content/. Le point initial situé devant son nom indique qu’il s’agit d’un fichier caché pour les systèmes d’exploitation basés sur Unix (comme macOS et Linux).

Pour le visualiser sur votre ordinateur en développement local :

  • Sur macOS (Finder) : utilisez le raccourci clavier Cmd + Shift + . pour faire apparaître les fichiers masqués.
  • Dans votre terminal : listez le contenu du dossier avec l’argument ls -la.
  • Dans votre éditeur de code : le fichier apparaît naturellement dans l’arborescence du projet s’il n’est pas exclu par vos préférences d’affichage.

Les règles natives de réécriture de WordPress décryptées

Dès que vous choisissez une structure de permaliens personnalisée dans l’administration (par exemple /%postname%/), WordPress génère automatiquement un bloc de réécriture standard :

# BEGIN WordPress
# Les directives (lignes) entre « BEGIN WordPress » et « END WordPress » sont générées
# dynamiquement, et doivent être modifiées uniquement via les filtres WordPress.
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Ce bloc s’appuie sur le module Apache mod_rewrite. Voici ce qu’il accomplit ligne par ligne :

  • RewriteEngine On : active le moteur de réécriture d’URL du serveur web.
  • RewriteCond %{REQUEST_FILENAME} !-f : vérifie si la ressource demandée par l’internaute ne correspond pas à un fichier existant réellement sur le disque (comme une image, un fichier CSS ou un document PDF).
  • RewriteCond %{REQUEST_FILENAME} !-d : vérifie que la requête ne pointe pas vers un répertoire physique existant sur le serveur.
  • RewriteRule . /index.php [L] : si la cible n’est ni un fichier ni un dossier physique, le serveur redirige la requête vers le fichier index.php à la racine. Ce fichier fait office de contrôleur frontal (Front Controller) : il analyse l’URL demandée et interroge la base de données pour charger le bon contenu selon la hiérarchie des templates.

Règle capitale d’édition : ne modifiez jamais le code présent entre les balises # BEGIN WordPress et # END WordPress. WordPress écrase systématiquement ce contenu dès que vous enregistrez les réglages de permaliens. Toutes vos règles personnalisées doivent obligatoirement être insérées avant ou après ce bloc balisé.

Mettre en place des redirections 301 pour préserver le SEO

Lors de la refonte d’un site web, de la suppression d’un article obsolète ou du changement de structure d’une URL, le fichier .htaccess permet de renvoyer immédiatement les visiteurs et les moteurs de recherche vers la nouvelle adresse sans passer par du code PHP :

# Redirection 301 permanente d'une page individuelle
Redirect 301 /ancienne-page/ /nouvelle-page/

# Redirection vers un domaine externe
Redirect 301 /ressource/ https://site-externe.com/cible/

L’utilisation d’une redirection permanente 301 transmet la quasi-totalité du capital SEO (le PageRank) accumulé par l’ancienne adresse vers la nouvelle, tout en évitant aux internautes de tomber sur une page d’erreur 404.

Code HTTPType de redirectionImpact SEOUsage recommandé
301Redirection permanenteTransmet le jus de lien (PageRank)Changement d’URL définitif, migration de domaine.
302Redirection temporaireNe transmet pas le PageRankMaintenance ponctuelle, test A/B temporaire.
410Contenu supprimé (Gone)Désindexation rapide par GoogleSuppression définitive sans page de remplacement.

Renforcer la sécurité avec des règles .htaccess sur mesure

En complément de son rôle d’aiguillage d’URL, .htaccess est un outil de défense de premier ordre pour votre serveur web. Voici trois règles de sécurité recommandées à placer au tout début de votre fichier :

  • Bloquer l’accès aux fichiers sensibles : pour empêcher la lecture externe de votre configuration et de vos outils de versioning :
    <FilesMatch "^(\.ht|\.git|\.env|wp-config\.php)">
    Order allow,deny
    Deny from all
    </FilesMatch>
  • Désactiver l’exploration des répertoires : pour empêcher les curieux de lister le contenu de vos dossiers en saisissant directement leur chemin dans le navigateur :
    Options -Indexes
  • Forcer la redirection globale vers le protocole HTTPS : pour s’assurer que l’ensemble du trafic transite de façon chiffrée :
    RewriteCond %{HTTPS} off
    RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Dépannage : résoudre les erreurs 404 et 500 récurrentes

Deux anomalies fréquentes sont directement liées au fichier .htaccess :

  • L’erreur 500 (Internal Server Error) : elle apparaît presque toujours à la suite d’une coquille de syntaxe dans .htaccess ou de l’appel d’un module Apache non activé sur l’hébergement. Pour rétablir l’accès immédiatement, renommez le fichier en .htaccess_backup via votre accès SFTP ou le terminal.
  • Toutes les pages renvoient une 404 sauf la page d’accueil : cette situation se produit lorsque les règles de réécriture sont manquantes ou désynchronisées. Pour la résoudre, rendez-vous dans le tableau de bord sous Réglages > Permaliens et cliquez simplement sur le bouton Enregistrer les modifications sans rien modifier. Cette action force WordPress à réécrire le fichier.

Questions fréquentes

Pourquoi mon fichier .htaccess est-il invisible sur mon ordinateur ?

Le point situé devant le nom du fichier indique au système d’exploitation qu’il s’agit d’un fichier masqué. Sur macOS, appuyez simultanément sur Cmd + Shift + . dans le Finder pour afficher les fichiers cachés. Dans un terminal, utilisez la commande ls -la.

Le fichier .htaccess fonctionne-t-il sur les serveurs Nginx ?

Non. Nginx ne prend pas en charge les fichiers .htaccess décentralisés pour des raisons de performance. Si votre site WordPress est hébergé sur un serveur Nginx pur, les directives de réécriture d’URL et de sécurité doivent être configurées directement dans le fichier de configuration principal du serveur (nginx.conf).

Comment restaurer un fichier .htaccess corrompu dans WordPress ?

Supprimez le fichier .htaccess corrompu depuis votre gestionnaire de fichiers ou via FTP. Connectez-vous ensuite à l’espace d’administration de WordPress, rendez-vous dans Réglages > Permaliens et cliquez sur Enregistrer les modifications. WordPress régénère instantanément un fichier .htaccess sain et fonctionnel.

Peut-on insérer des règles .htaccess dans des sous-dossiers ?

Oui. Les fichiers .htaccess ont une portée descendante et s’appliquent au répertoire qui les contient ainsi qu’à tous ses sous-dossiers. Il est par exemple très courant de placer un fichier .htaccess spécifique dans wp-content/uploads/ pour désactiver l’exécution des scripts PHP dans les médias.