Comment résoudre les problèmes du fichier .htaccess sur WordPress

Pour résoudre les problèmes du fichier .htaccess sur WordPress, commencez par en sauvegarder une copie, puis vérifiez ses règles et ses permissions. Si le fichier semble corrompu, vous pouvez le renommer et demander à WordPress de régénérer ses règles de permaliens. Une erreur persistante peut aussi venir d’une extension ou de la configuration du serveur.

À quoi sert le fichier .htaccess sur WordPress ?

Le fichier .htaccess est un fichier de configuration utilisé par le serveur web Apache. Il se trouve généralement à la racine du site, dans le même dossier que wp-config.php. Son nom commence par un point : selon votre outil, il peut être masqué.

Sur WordPress, ce fichier sert notamment à faire fonctionner les permaliens, c’est-à-dire les adresses lisibles des pages et des articles. Il peut aussi contenir des règles de redirection, de sécurité ou d’autres directives ajoutées par des extensions.

Une règle incorrecte ou non acceptée par le serveur peut provoquer une erreur. Toutefois, le fichier .htaccess n’est pas utilisé de la même façon sur tous les serveurs : si votre hébergement n’utilise pas Apache, vérifiez sa configuration avant de suivre la procédure de régénération.

Reconnaître les problèmes liés au fichier .htaccess

Une erreur liée à .htaccess peut se manifester par une erreur serveur, des pages introuvables ou des redirections inattendues. Ces symptômes ne prouvent pas à eux seuls que le fichier est en cause : une extension ou une configuration de l’hébergement peut également être responsable.

Pour orienter votre recherche, demandez-vous ce qui a changé avant l’apparition du problème :

• Avez-vous modifié le fichier ou ajouté une règle de redirection ?
• Une extension de sécurité ou de gestion des redirections a-t-elle été installée ou configurée ?
• Les pages sont-elles devenues introuvables après une modification des permaliens ?
• Le problème touche-t-il toutes les pages ou seulement certaines adresses ?

Si les adresses tournent en boucle ou renvoient vers une mauvaise destination, consultez également les pistes pour les erreurs de redirection sur WordPress. Notez le message affiché et les pages concernées avant de modifier quoi que ce soit.

Sauvegarder et vérifier le fichier .htaccess

Avant toute intervention, téléchargez une copie du fichier sur votre ordinateur. Vous pourrez ainsi remettre les règles précédentes en place si la modification ne résout pas le problème.

1. Connectez-vous à votre hébergement avec un client FTP ou ouvrez le gestionnaire de fichiers de votre hébergeur.
2. Accédez au dossier racine de WordPress. Activez l’affichage des fichiers cachés si .htaccess n’apparaît pas.
3. Téléchargez le fichier et conservez cette copie sans la modifier.
4. Ouvrez une autre copie dans un éditeur de texte et examinez les règles ajoutées récemment.
5. Vérifiez les fautes de syntaxe, les lignes incomplètes ou les directives qui se contredisent.

Si l’erreur est apparue juste après une modification, restaurez la version sauvegardée avant cette modification, si vous en disposez. Testez ensuite l’accueil et plusieurs pages internes. Évitez de supprimer plusieurs règles à la fois : vous pourrez ainsi identifier plus facilement celle qui pose problème.

Vérifiez également les permissions du fichier dans votre outil FTP ou le gestionnaire de fichiers. Le serveur doit pouvoir le lire ; WordPress ne peut le modifier que si les droits d’écriture le permettent. Ne rendez pas le fichier accessible en écriture à tous les utilisateurs pour contourner un problème de permissions. En cas de doute, vérifiez les réglages recommandés par votre hébergeur.

Régénérer les règles de permaliens WordPress

Si le fichier semble corrompu et que vous avez accès à l’administration, vous pouvez laisser WordPress recréer ses règles de permaliens. Cette opération ne remet pas nécessairement en place les règles personnalisées, notamment celles des extensions ou les redirections ajoutées manuellement.

1. Téléchargez d’abord une copie du fichier .htaccess existant.
2. Dans votre outil FTP ou le gestionnaire de fichiers, renommez-le, par exemple en .htaccess-ancien.
3. Connectez-vous à l’administration WordPress et ouvrez Réglages > Permaliens.
4. Sans changer la structure choisie, cliquez sur Enregistrer les modifications.
5. Vérifiez si un nouveau fichier .htaccess a été créé, puis testez l’accueil et plusieurs pages internes.

Si WordPress ne peut pas écrire le fichier, il peut afficher les règles à ajouter manuellement. Vérifiez alors les permissions et les indications de votre hébergeur. Si le problème persiste ou si des règles importantes manquent, vous pouvez restaurer la copie précédente en lui redonnant le nom .htaccess.

Testez aussi les redirections et les fonctions de sécurité qui dépendaient de l’ancien fichier. Ne recopiez les règles personnalisées qu’après les avoir vérifiées, afin de ne pas réintroduire la directive responsable de l’erreur.

Vérifier les extensions et la configuration de l’hébergement

Certaines extensions peuvent ajouter ou modifier des règles dans .htaccess. Si le problème est apparu après l’installation ou la modification d’une extension, examinez ses réglages et comparez le fichier actuel avec votre sauvegarde.

Des extensions de sécurité comme Better WP Security, iThemes Security ou All In One WP Security & Firewall sont citées parmi les outils pouvant intervenir sur la sécurité du site. Leurs options et leurs noms peuvent évoluer : vérifiez leur fonctionnement avant de leur confier une modification du fichier. Une extension ne remplace pas la sauvegarde et la vérification des règles.

Si vous ne trouvez pas la cause, l’hébergeur peut vérifier les journaux du serveur et indiquer si une directive est interdite ou incompatible avec sa configuration. Transmettez-lui le message d’erreur, les pages touchées et les changements récents. Pour une panne qui dépasse le fichier, un dépannage de site WordPress permet aussi de rechercher d’autres causes.

Traiter séparément une erreur de mémoire épuisée

Une erreur de mémoire PHP n’indique pas nécessairement un problème de .htaccess. L’ajout d’une directive de mémoire dans ce fichier n’est pas adapté à toutes les configurations et peut lui-même provoquer une erreur serveur.

Selon l’hébergement, la limite de mémoire peut être réglée dans la configuration PHP, notamment dans php.ini. Vérifiez d’abord la méthode acceptée par votre hébergeur et recherchez ce qui consomme la mémoire. Pour les étapes de diagnostic, consultez le guide sur l’erreur « mémoire épuisée » sur WordPress.

Pour prévenir les erreurs futures, gardez une copie de .htaccess avant chaque modification et notez les règles personnalisées ajoutées. Après une intervention sur les permaliens, les redirections ou une extension de sécurité, testez les pages concernées et conservez une version fonctionnelle du fichier.

Questions fréquentes

Article rédigé avec l’aide d’une IA à partir des sources citées et de notre pratique de la maintenance WordPress. Notre méthode éditoriale.