Développement et bases de données

Le fichier .htaccess : ce qu'il faut savoir

Vérifié le 3 min de lecture .htaccess Apache

Le fichier .htaccess vous permet de personnaliser certaines options du serveur web dans un répertoire ou une arborescence de répertoires. Parmi ces options :

  • Personnaliser les pages d'erreur
  • Configurer l'affichage de la liste des fichiers d'un répertoire
  • Ajouter des règles pour mod_rewrite
  • Refuser l'accès à certaines IP
  • Ajouter des types MIME
  • Effectuer des redirections
  • Modifier des options PHP quand le gestionnaire le permet

Et bien d'autres possibilités.

Le fichier .htaccess agit de façon récursive : si vous avez un fichier .htaccess dans public_html avec certaines personnalisations, elles peuvent aussi s'appliquer à ses sous-répertoires. Le comportement exact dépend de la directive et des règles des répertoires inférieurs ; un second .htaccess n'annule pas forcément tout le premier.

N'importe quel répertoire peut utiliser un fichier .htaccess : il suffit de créer, par FTP ou avec le gestionnaire de fichiers de cPanel, un fichier nommé .htaccess (le point au début est important) et de le modifier comme un fichier texte brut.

Le trouver et le modifier

  1. Confirmez la racine du domaine ou du dossier que vous voulez configurer ; tous les domaines d'un compte n'utilisent pas directement public_html.
  2. Dans le gestionnaire de fichiers, activez l'affichage des fichiers cachés. Le nom commence par un point et ne doit pas se terminer par .txt.
  3. S'il existe déjà, téléchargez-en une copie privée avant de le modifier. Ne remplacez pas tout le contenu par un exemple qui ne contient qu'une règle.
  4. Ajoutez la modification en dehors des blocs que l'application régénère, sauf si sa documentation indique autre chose.
  5. Enregistrez, testez l'URL concernée et vérifiez aussi une page qui ne doit pas changer.

Le serveur doit autoriser la directive dans ce contexte. Une règle valide dans la configuration principale d'Apache peut ne pas être autorisée dans .htaccess. Chez Hostsuar, LiteSpeed interprète les règles compatibles ; utilisez des instructions adaptées au service.

Si une erreur apparaît après la modification

Restaurez le contenu précédent et vérifiez que le site revient. Consultez le journal pour repérer des erreurs de syntaxe ou des directives non prises en charge. Ne passez pas les permissions à 777 et ne supprimez pas toutes les règles pour résoudre une erreur 500.

Pour une redirection, vérifiez aussi la destination, le code HTTP et l'éventuelle boucle. Le navigateur ou un cache peuvent conserver une redirection précédente ; testez sans ce cache avant de conclure que la règle ne fonctionne pas.

Consultez les guides sur mod_rewrite et la page de maintenance pour des tâches précises.

Cela peut aussi vous aider

Quelque chose cloche ou a changé ? Racontez-nous et nous le vérifions.