Le fichier .htaccess peut contenir des paramètres importants pour un site Web. Elle est utilisée sur les serveurs Web basés sur Apache configurés en conséquence pour définir certaines règles directement au niveau du répertoire ou du site Web.
Cela peut inclure, par exemple, des redirections, des réécritures d'URL, des restrictions d'accès ou des règles spécifiques à l'application.
Sur WordPress, joue .htaccess joue souvent un rôle important dans la structure des permaliens.
Dans ce guide, nous vous montrons comment .htaccess-fichier dans le cPanel de CURIAWEB, comment le sauvegarder, le modifier et le vérifier après modification. Nous expliquons également comment procéder si une erreur survient après une modification.
Important : Une seule ligne erronée dans
.htaccesspeut empêcher qu'un site Web ne soit plus accessible correctement. Créez par conséquent une sauvegarde du fichier existant avant chaque modification.
Qu'est-ce que .htaccess ? #
.htaccess est un fichier de configuration qui, avec une configuration Apache appropriée, peut contenir des directives pour un répertoire spécifique et ses sous-répertoires.
Le nom commence par un point :
.htaccess
Cela fait en sorte que, sous les systèmes basés sur Linux, le fichier devient un fichier caché ou Fichier point traité.
Si vous ne les voyez pas dans le gestionnaire de fichiers, vous devrez peut-être d'abord activer l'affichage des fichiers cachés.
Vous trouverez la procédure exacte sous Afficher les fichiers cachés comme .htaccess dans cPanel.
À quoi sert le fichier .htaccess ? #
Selon le site Web et la configuration du serveur, .htaccess assumer différentes tâches.
Les domaines d'application typiques sont :
- Réécritures d'URL
- Redirections
- Restrictions d'accès
- Règles pour certains types de fichiers
- configurations spécifiques à l'application
- Règles de permaliens sous WordPress
Toutes les sites web n'ont pas besoin des mêmes règles et tous les .htaccess- Le fichier a la même apparence.
Important : Ne copiez jamais le complet
.htaccessd'un site web tiers dans votre propre installation, simplement parce qu'une application similaire y est utilisée.
1. Ouvrir le Gestionnaire de fichiers cPanel #
Connecte-toi à ton cPanel CURIAWEB et ouvre :
Fichiers → Gestionnaire de fichiers
Si vous n'êtes pas encore familiarisé avec le gestionnaire de fichiers, vous trouverez une introduction détaillée sur Utiliser le gestionnaire de fichiers cPanel.
2. Afficher les fichiers cachés #
Oui .htaccess commence par un point, elle peut être masquée dans le gestionnaire de fichiers.
Ouvrez en haut à droite le Paramètres et active :
Afficher les fichiers cachés (fichiers point)
Enregistrez ensuite le paramètre.
3. Ouvrir le bon répertoire de site web #
Naviguer vers la racine du document du site Web, dont .htaccess que vous souhaitez modifier.
Pour le domaine principal, c'est souvent le cas dans une configuration cPanel typique :
public_html
Cependant, pour des domaines ou sous-domaines supplémentaires, une racine de document différente peut être utilisée.
Attention : Pour plusieurs sites Web, plusieurs
.htaccess-fichiers doivent être présents. Par conséquent, vérifiez toujours si vous vous trouvez dans le bon répertoire.
4. Rechercher le fichier .htaccess #
Rechercher dans le répertoire souhaité :
.htaccess
Dans une installation WordPress, elle peut par exemple, avec des fichiers et des dossiers tels que :
.htaccess
index.php
wp-admin/
wp-content/
wp-includes/
wp-config.php
se trouvent dans le répertoire principal de l'installation.
S'il n'y a pas de fichier .htaccess #
Si le fichier n'existe pas malgré l'affichage activé des fichiers cachés, tu ne devrais pas créer automatiquement un nouveau fichier.
Vérifie d'abord :
- si vous êtes dans la bonne racine de documents
- si le site Web est réellement un
.htaccessnécessaire - si l'application utilisée crée généralement le fichier elle-même
- qu'elle a peut-être été renommée
Chaque site Web et chaque configuration de serveur n'ont pas nécessairement besoin d'un .htaccess-Fichier.
5. Sauvegarder le fichier .htaccess avant modification #
Avant d'apporter des modifications, vous devez créer une sauvegarde du fichier existant.
Marquer :
.htaccess
et télécharge-les sur ton ordinateur.
Vous pouvez également créer temporairement une copie, par exemple :
.htaccess-backup
Conseil pratique : La méthode de travail la plus sûre est : télécharger l'original, effectuer la modification, tester le site web et, en cas d'erreur, restaurer immédiatement la version précédente.
Nous vous montrons en détail comment télécharger et modifier des fichiers sur Télécharger, charger et modifier des fichiers dans cPanel.
6. Ouvrir .htaccess dans l'éditeur #
Marque le fichier .htaccess et choisis Modifier.
cPanel ouvre ensuite le contenu dans l'éditeur intégré.
Vérifiez d'abord le contenu existant avant d'apporter des modifications.
Détecter les commentaires dans .htaccess #
Les lignes qui commencent par un double dièse sont généralement utilisées comme commentaires.
Par exemple :
# Redirections personnalisées
# Ne pas modifier les règles WordPress
Les commentaires sont utiles pour documenter ses propres zones ou modifications.
Cela peut faciliter le dépannage ultérieur, en particulier pour les fichiers plus volumineux.
7. N'effectuer que les modifications nécessaires #
Modifiez si possible uniquement la règle concrète qui doit effectivement être ajustée.
Si vous insérez simultanément plusieurs modifications indépendantes, le dépannage devient nettement plus difficile.
Règle de base : Effectuer une modification, enregistrer, tester – et seulement ensuite procéder à la modification suivante.
L'ordre des règles peut être important. #
En ce qui concerne les redirections et les règles de réécriture, l'ordre des différentes instructions peut jouer un rôle.
Une règle formulée de manière générale peut par exemple influencer une règle plus spécifique qui lui succède.
N'ajoutez donc pas de nouvelles règles au hasard n'importe où.
Redirections via .htaccess #
.htaccess peut être utilisé pour rediriger des visiteurs d'une URL vers une autre.
Avec une configuration Apache appropriée, une simple redirection permanente peut par exemple être mise en œuvre fondamentalement avec une instruction telle que celle-ci :
Redirection 301 /alte-seite/ https://example.com/neue-seite/
Cela entraîne une redirection HTTP permanente avec le code d'état 301 utilisé.
Important : N'utilisez pas de domaine d'exemple de ce guide sur un site web de production. Adaptez toujours les règles exactement à votre véritable domaine et à votre structure d'URL.
Ne pas confondre 301 et 302 #
Une redirection 301 indique fondamentalement un déplacement permanent.
Une Redirection 302 signale fondamentalement une redirection temporaire.
La variante qui est correcte dépend du but de la redirection.
Lorsqu'une ancienne URL a été définitivement remplacée par une nouvelle, il est souvent 301 la variante appropriée.
Éviter les boucles de redirection #
Des règles de redirection incorrectes peuvent amener une URL à se rediriger indéfiniment vers elle-même ou entre plusieurs URL.
Le navigateur signale alors, par exemple, un nombre trop important de redirections.
Si une telle erreur immédiatement après une nouvelle .htaccess-règle apparaît, supprime ou corrige d'abord la règle ajoutée en dernier.
Comprendre les règles de réécriture #
Les réécritures d'URL plus complexes sont souvent effectuées via mod_rewrite mis en œuvre.
Cela peut inclure, entre autres, des directives telles que :
RewriteEngine
RewriteCond
Règle de réécriture
être utilisé.
Un début typique d'une telle section peut être, par exemple :
RewriteEngine On
Cependant, la logique concrète dépend entièrement du comportement souhaité.
Attention : Les règles de réécriture peuvent être très puissantes. Ne copiez pas de règle complexe d'Internet sur un site web en production si vous ne comprenez pas les conditions, la cible et les effets secondaires possibles.
WordPress et .htaccess #
WordPress peut, sur des configurations de serveurs basées sur Apache ou compatibles .htaccess pour les permaliens dits jolis.
Les règles correspondantes permettent par exemple des URL telles que :
au lieu d'adresses purement basées sur des paramètres.
Détecter la zone WordPress #
Gérée par WordPress .htaccess peut contenir une zone WordPress marquée.
On le reconnaît généralement à des commentaires tels que :
# BEGIN WordPress
...
# END WordPress
Cette zone peut être gérée ou réécrite par WordPress lui-même.
Important : Vous ne devez pas placer étourdiment vos propres règles permanentes à l'intérieur d'une zone gérée automatiquement par WordPress. WordPress peut régénérer cette section lors de certaines modifications.
Les permaliens WordPress ne fonctionnent pas #
Si la page d'accueil fonctionne mais que les sous-pages renvoient une erreur 404, les règles de réécriture ou de permaliens peuvent constituer un point de vérification possible.
Sous WordPress, il peut être utile d'ouvrir les réglages des permaliens dans le tableau de bord et de les enregistrer à nouveau correctement, pour autant que les autorisations du serveur et des fichiers le permettent.
Modifier .htaccess pas à titre préventif, tant que la cause n'a pas encore été déterminée.
Ajouter ses propres règles dans WordPress #
Si vous avez besoin de vos propres règles, vous devez tenir compte des zones de WordPress qui sont gérées automatiquement.
Documentez vos propres règles avec des commentaires, par exemple :
# CURIAWEB - redirection personnalisée
Redirection 301 /alt/ https://example.com/neu/
Il est ainsi plus facile de comprendre par la suite quelles règles ont été ajoutées manuellement.
Enregistrer la modification #
Vérifiez attentivement votre adaptation.
Enregistrez ensuite le fichier dans l'éditeur cPanel.
La modification prend effet directement sur le serveur.
Tester le site web immédiatement #
Ouvrir le site Web concerné immédiatement après l'enregistrement.
Ne teste pas seulement la page d'accueil, mais cible spécifiquement la fonction que tu as modifiée.
Lors d'une redirection, vous devriez par exemple vérifier à la fois l'ancienne et la nouvelle URL.
Pour les règles de permaliens, vous devez visiter plusieurs sous-pages.
Prendre en compte le cache du navigateur lors des redirections #
Les navigateurs peuvent mettre en cache les redirections permanentes.
Si tu es à un 301-redirection et que le comportement reste inchangé malgré la modification, une redirection mise en cache peut également jouer un rôle.
Testez si nécessaire dans une fenêtre de navigation privée ou à l'aide d'un outil d'inspection HTTP approprié.
Après la modification, une erreur interne du serveur 500 apparaît #
L'un des indices les plus courants d'un dysfonctionnement .htaccess-Modification est un :
500 Erreur interne du serveur
Si l'erreur survient immédiatement après l'enregistrement, la dernière règle insérée ou modifiée constitue une zone de suspicion importante.
10. En cas d'erreur 500, restaurer la version précédente #
Ouvre le gestionnaire de fichiers et remplace le défectueux .htaccess par votre version précédemment sauvegardée.
Ensuite, testez à nouveau le site web.
Si elle refonctionne ensuite, la cause venait très probablement de la modification effectuée.
Nous traitons l'analyse complète des erreurs sous Résoudre l'erreur interne du serveur 500.
.Renommer temporairement le fichier .htaccess à des fins de diagnostic #
Si vous souhaitez examiner si une existante .htaccess provoqué une erreur, le fichier peut être renommé à titre d'essai.
Par exemple de :
.htaccess
à
.test-.htaccess
Le serveur web ne les traite plus sous ce nom comme des normales .htaccess-Fichier.
Ensuite, recharge le site Web.
Attention : Le renommage peut supprimer temporairement les redirections, les permaliens, la protection d'accès ou d'autres règles. N'utilisez cette méthode que brièvement à des fins de diagnostic.
Que dit le test ? #
Si le site Web avec renommé .htaccess à nouveau fonctionne, le fichier ou une règle qu'il contient constitue une zone fortement suspecte.
Si le problème persiste, la cause est probablement ailleurs.
Cependant, le changement de nom ne prouve pas automatiquement quelle règle individuelle est défectueuse.
.restaurer ensuite le fichier .htaccess #
Après le test, vous devez remettre la date à son nom d'origine :
.htaccess
ou utiliser une version correctement nettoyée.
Ne laissez pas un fichier renommé à des fins de diagnostic désactivé de manière permanente par inadvertance.
403 Interdit après modification de .htaccess #
.htaccess peut également contenir des règles qui restreignent l'accès à certains répertoires, fichiers ou visiteurs.
Si après une modification soudainement un 403 Interdit apparaît, c'est pourquoi il faut également vérifier les règles d'accès modifiées récemment.
Nous traitons le diagnostic complet sous Résoudre l'erreur 403 Forbidden.
Vérifier les autorisations de fichier du fichier .htaccess #
Les autorisations du fichier peuvent également être pertinentes.
Pour de nombreux fichiers de sites Web normaux 644 une valeur typique, mais le paramètre concret dépend de la configuration du serveur.
Nous expliquons comment fonctionnent les autorisations et comment les modifier sous Définir correctement les autorisations de fichiers 644 et 755 dans cPanel.
.Ne pas régler .htaccess sur 777 #
Si une application ne peut pas écrire dans le fichier, vous ne devriez pas simplement le :
777
mettre.
Vérifiez plutôt les autorisations, la titularité et le message d'erreur concret.
Plus plusieurs fichiers .htaccess peuvent agir simultanément #
Dans une structure de répertoires, plusieurs .htaccess-les fichiers doivent être présents.
Un fichier dans le répertoire parent peut définir des paramètres, tandis qu'un autre fichier dans un sous-répertoire contient des règles supplémentaires.
Par conséquent, lorsque vous étudiez une erreur, vous ne devez pas automatiquement examiner uniquement le premier fichier trouvé.
Exemple de structure de répertoire #
public_html/
.htaccess
index.php
shop/
.htaccess
index.php
Dans cet exemple, pour le répertoire boutique aussi bien les règles de niveau supérieur que celles qui y sont définies peuvent être pertinentes.
Les règles peuvent s'influencer mutuellement. #
Chez plusieurs .htaccessfichiers et des règles de réécriture complexes, le comportement résultant peut devenir difficile à comprendre.
Documentez par conséquent vos propres adaptations et évitez les règles doublement inutiles.
Éviter les doubles redirections #
Si une redirection est déjà mise en place par WordPress, un plugin, cPanel ou une autre configuration de serveur, tu ne devrais pas ajouter la même logique sans raison dans .htaccess inscrire.
Plusieurs règles concurrentes peuvent provoquer des chaînes de redirection ou des boucles.
Redirections cPanel et .htaccess #
Si vous configurez une redirection via la fonction cPanel correspondante, celle-ci peut également être mise en œuvre techniquement via des règles de serveur web.
Si vous effectuez ensuite également manuellement une .htaccess tu travailles, tu devrais donc vérifier quelles règles existent déjà.
Traiter les redirections HTTPS avec précaution #
Les redirections de HTTP vers HTTPS sont souvent mises en œuvre via des règles de serveur web.
Si votre site Web dispose déjà d'une redirection HTTPS via un autre niveau, une règle manuelle supplémentaire peut entraîner des redirections en double ou erronées.
Vérifiez par conséquent d'abord la configuration existante.
Ne pas forcer simultanément www et non-www de manière contradictoire #
Une site web peut par exemple être sur :
ou
être canonisé.
Cela devient problématique lorsque des règles différentes exigent simultanément l'autre variante.
Cela peut entraîner une boucle de redirection.
Ne pas utiliser les règles provenant d'Internet sans vérification #
De nombreux anciens manuels contiennent des règles qui ont été écrites pour une configuration de serveur, une version d'Apache ou une application spécifique.
Une règle peut par conséquent être inutile, inefficace ou erronée sur un autre système.
Sécurité N'adoptez que les règles dont vous comprenez le but et dont vous pouvez évaluer la source. Vous ne devez en particulier pas utiliser de règles de réécriture et d'accès inconnues sans vérification sur un site web en production.
Ne pas enregistrer d'informations d'identification dans les commentaires .htaccess #
Les commentaires sont pratiques pour les notes techniques, mais ne constituent pas un emplacement de stockage sécurisé pour les informations confidentielles.
N'y enregistrez pas :
- Mots de passe
- Clé d'API
- Accès à la base de données
- coordonnées d'accès personnelles
.Ne pas rendre le fichier .htaccess public #
Si vous avez besoin d'assistance, vous ne devez pas publier sans vérification le contenu de fichiers de configuration sensibles publiquement sur des forums ou des réseaux sociaux.
Supprime ou anonymise les informations confidentielles avant de partager des extraits.
Documenter les modifications #
Sur un site web de production, il vaut la peine de documenter clairement les modifications manuelles importantes afin qu'elles soient traçables.
Vous pouvez par exemple ajouter un commentaire :
# CURIAWEB - redirection permanente de l'ancienne URL
Redirection 301 /alt/ https://example.com/neu/
De plus, vous devez consigner en dehors du fichier quand et pourquoi la modification a été apportée.
Supprimer à nouveau les fichiers de sauvegarde temporaires #
Si vous faites des copies telles que :
.htaccess-backup
.htaccess-old
.test-.htaccess
que vous avez créés, vous devriez vérifier après la fin des travaux s'ils sont encore nécessaires.
Ne laissez pas de copies de configuration inutiles de manière permanente dans des répertoires accessibles au public.
Procédure recommandée lors d'une modification de .htaccess #
- Ouvrir Fichiers → Gestionnaire de fichiers.
- Activez l'affichage des fichiers cachés.
- Ouvrez la racine des documents du site Web approprié.
- Recherche
.htaccess. - Téléchargez le fichier d'origine comme sauvegarde.
- Ouvrir
.htaccessJe suis un éditeur. - Ne modifiez que la règle nécessaire.
- Enregistre le fichier.
- Testez immédiatement la fonction du site Web concernée.
- Restaurez la version précédente en cas d'erreur.
Procédure recommandée en cas d'erreur #
- Vérifiez si l'erreur survient immédiatement après une
.htaccess-changement s'est produit. - Restaurez la version précédemment sauvegardée.
- Testez à nouveau le site web.
- S'il n'y a pas de sauvegarde, nommez
.htaccessbrièvement pour un diagnostic. - Vérifiez si le profil d'erreur change.
- Analysez ensuite les règles suspectes une par une.
- Rétablissez la configuration correcte requise.
Règle de base : Utilise
.htaccessMéthodiquement. Sauvegarde le fichier avant toute modification, ne change qu'une seule chose à la fois et teste immédiatement après.
Quand devez-vous contacter le support ? #
Lorsqu'un site web demande une .htaccess-modification n'est plus accessible ou qu'une règle ne fonctionne pas comme prévu, tu dois documenter la dernière modification effectuée.
Pour une analyse, les informations suivantes sont notamment utiles :
- domaine concerné
- Répertoire des
.htaccess - quelle fonction devrait être mise en œuvre
- quelle règle a été modifiée ou complétée
- l'erreur qui se produit ensuite
- si le site web avec le précédent
.htaccessfonctionne - le cas échéant, le code d'erreur HTTP
Ne partagez pas de mots de passe, de clés API ou d'autres identifiants confidentiels dans une description de bug normale.
Résumé #
.htaccess est un fichier de configuration important pour les sites Web sur les serveurs Web basés sur Apache configurés en conséquence. Il peut contenir, entre autres, des redirections, des règles de réécriture, des restrictions d'accès et des règles de permaliens WordPress.
Comme le fichier commence par un point, vous devrez peut-être d'abord, dans le gestionnaire de fichiers cPanel, Afficher les fichiers cachés (fichiers point) activer.
Créez une sauvegarde du fichier existant avant chaque modification. Modifiez ensuite uniquement la règle strictement nécessaire et testez le site web immédiatement après l'enregistrement.
Si, après une modification, une erreur 500 ou 403 apparaît, restaurez d'abord la version précédente ou utilisez un renommage à court terme uniquement pour un diagnostic ciblée.
Ne copiez pas d'inconnus .htaccess-Règles ou fichiers de configuration complets de sites web tiers sans vérification dans votre propre installation. En particulier avec les règles de réécriture et de redirection, de petites différences peuvent avoir de grandes répercussions.