# Comprendre .htaccess sur KapsuleHost

Source: https://support.kapsulehost.com/fr-fr/wordpress-htaccess

KapsuleHost dessert chaque site avec un serveur web haute performance qui ne lit pas `.htaccess`, donc les règles que vous ajoutez à ce fichier n'ont aucun effet : ce guide explique ce que cela signifie pour un site WordPress et montre le réglage KPanel qui accomplit chaque tâche à la place.

Si vous êtes venu d'un hébergement cPanel mutualisé, `.htaccess` était probablement l'endroit où vous placiez les redirections, le forçage HTTPS, les pages d'erreur personnalisées et les blocages de robots. Toutes ces choses fonctionnent toujours sur KapsuleHost. Elles sont simplement définies dans KPanel plutôt que dans un fichier texte, et comme elles sont appliquées au niveau du serveur, elles sont plus rapides et ne peuvent pas casser votre site à cause d'une faute de frappe.

## Pourquoi .htaccess ne fait rien ici

`.htaccess` est un fichier de configuration par répertoire pour le serveur web Apache. Apache le relit à chaque requête, ce qui le rend pratique mais aussi lent.

KapsuleHost ne fait pas tourner Apache. Votre site est servi par un serveur web piloté par événements qui charge sa configuration une seule fois au démarrage, ce qui explique en grande partie pourquoi les sites ici répondent plus vite sous charge. Ce serveur n'a aucun équivalent de fichier de surcharge par répertoire, donc il n'ouvre jamais `.htaccess`.

> **Warning:** Ajouter des règles à `.htaccess` sur un site KapsuleHost échoue silencieusement. Rien ne génère d'erreur, rien n'avertit, et le fichier reste exactement là où vous l'avez laissé. Les règles ne s'exécutent tout simplement jamais. Si vous suivez un tutoriel WordPress qui dit « ajoutez ceci à votre .htaccess », trouvez plutôt l'équivalent KPanel dans le tableau ci-dessous.

La bonne nouvelle est l'inverse de l'habituelle mésaventure liée à `.htaccess` : une erreur de syntaxe dans le fichier ne peut pas faire tomber votre site ici, car rien ne l'analyse.

## Ce qui fonctionne toujours sans lui

**Les permaliens.** La raison la plus courante pour laquelle un site WordPress a besoin de `.htaccess` sur Apache, ce sont les permaliens conviviaux. Sur KapsuleHost, la réécriture est intégrée à la configuration serveur de votre site, donc `/2026/07/my-post/` se résout via WordPress sans aucun bloc `.htaccess`. Si les permaliens renvoient des erreurs 404, la cause est ailleurs : voir [Résoudre les problèmes de permaliens WordPress](https://support.kapsulehost.com/fr-fr/wordpress-permalink-issues).

**WordPress qui écrit dans le fichier.** WordPress et certaines extensions écrivent encore des blocs `# BEGIN`/`# END` dans `.htaccess` parce qu'ils supposent la présence d'Apache. C'est sans danger. Le fichier est réel, il est modifiable, et vous le verrez dans le gestionnaire de fichiers. Il n'a simplement aucun lecteur.

**Les extensions de sécurité qui annoncent un « renforcement appliqué ».** Les extensions qui prétendent avoir verrouillé `xmlrpc.php` ou `wp-config.php` en modifiant `.htaccess` n'ont en réalité rien protégé sur cette plateforme. Utilisez plutôt l'onglet **Sécurité** du site, qui applique les règles équivalentes au niveau du serveur.

## Équivalents KPanel pour les règles .htaccess courantes

Chacun de ces réglages se trouve sur le site lui-même : **Sites web**, puis votre site, puis l'onglet indiqué.

| Ce que vous auriez écrit dans .htaccess | Où cela se trouve dans KPanel |
|---|---|
| `RewriteCond %{HTTPS} off` pour forcer HTTPS | **Paramètres**, puis **Forcer HTTPS** sous Behavior |
| `Redirect 301 /old /new` | **Paramètres**, puis **Redirections** |
| `ErrorDocument 404 /404.html` | **Paramètres**, puis **Pages d'erreur** |
| `AuthType Basic` pour protéger un dossier par mot de passe | **Paramètres**, puis **Protection par mot de passe** |
| `Require not ip 203.0.113.4` pour bloquer une adresse | **WordPress**, puis **Sécurité** |
| `RewriteCond %{HTTP_USER_AGENT} (BadBot)` pour bloquer les robots d'indexation | **Performances**, puis **Robots d'exploration** |
| `DirectoryIndex index.php index.html` | **Paramètres**, puis **Index du répertoire** sous Serving |
| `mod_deflate` / `mod_expires` pour la compression et la mise en cache | Déjà activé. La compression et les en-têtes de cache sont définis au niveau du serveur |

Deux de ces fonctionnalités font plus que ce que la version `.htaccess` n'a jamais pu faire. Les redirections prennent en charge les chemins exacts, les préfixes avec barre oblique finale et les jokers tels que `/blog/*`, et KPanel vérifie la redirection en direct après l'enregistrement. Les pages d'erreur sont servies avec leur véritable code de statut, de sorte qu'une page 404 personnalisée reste une véritable 404 pour les moteurs de recherche plutôt qu'une 200 accompagnée d'excuses.

![La page Redirects d'un site dans KPanel, où les redirections sont appliquées par le serveur web](https://support.kapsulehost.com/help/screenshots/wordpress-htaccess.1030a8b1.webp)

## Trouver et lire le fichier

Vous souhaiterez peut-être tout de même consulter `.htaccess`, généralement pour voir ce qu'une extension y a écrit ou pour en copier les règles avant de les recréer dans KPanel.

### Depuis l'onglet WordPress

1. Connectez-vous à [KPanel](https://kpanel.kapsulehost.com) et cliquez sur **Sites web** dans la barre latérale gauche.
2. Cliquez sur le site souhaité.
3. Ouvrez l'onglet **WordPress**, puis la section **wp-config**.
4. Faites défiler jusqu'au panneau `.htaccess`. Le contenu s'affiche en lecture seule, avec un bouton **Edit** si vous devez le modifier.

### Depuis le gestionnaire de fichiers

1. Ouvrez le site, puis **Paramètres**, puis **Gestionnaire de fichiers**.
2. Cliquez sur **Afficher les fichiers cachés** dans la barre d'outils. Les fichiers commençant par un point sont masqués par défaut, donc `.htaccess` n'apparaîtra pas tant que vous n'aurez pas fait cela.
3. Cliquez sur `.htaccess` pour l'ouvrir dans l'éditeur intégré.

Le fichier se trouve à la racine de votre site, aux côtés de `wp-config.php` et `wp-content`. Tous les détails sur l'éditeur et ses contrôles de permissions se trouvent dans [Utiliser le gestionnaire de fichiers](https://support.kapsulehost.com/fr-fr/file-manager).

> **Tip:** Faites une sauvegarde avant de modifier quoi que ce soit à la racine du site, même un fichier qui n'est pas lu. Cela ne coûte rien et vous permet de revenir en arrière en un clic. Voir [Effectuer une sauvegarde](https://support.kapsulehost.com/fr-fr/taking-a-backup).

## Le bloc WordPress par défaut

Pour référence, voici le bloc que WordPress écrit pour lui-même. Sur un hébergement Apache, il pilote les permaliens. Sur KapsuleHost, il est inerte, et le supprimer ne cassera rien :

```apache
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
```

Laissez-le en place si vous envisagez de déplacer le site vers un hébergement Apache plus tard. WordPress le réécrira de toute façon la prochaine fois que vous enregistrerez vos réglages de permaliens.

## Si vous migrez des règles

Lorsque vous transférez un site depuis cPanel, ouvrez l'ancien `.htaccess` avant de résilier l'ancien hébergement et parcourez-le ligne par ligne :

1. **Redirections.** Recréez chaque `Redirect` ou `RewriteRule` dans **Paramètres**, puis **Redirections**. Une ligne par règle. Choisissez 301 pour un déplacement permanent, 302 si le changement pourrait être inversé.
2. **Forçage HTTPS.** Supprimez-le. Activez plutôt **Forcer HTTPS** dans les **Paramètres** du site.
3. **Blocages d'IP.** Recréez-les dans **WordPress**, puis **Sécurité**, dans le panneau de blocage d'IP.
4. **En-têtes de mise en cache et de compression.** Supprimez-les. Ils sont pris en charge automatiquement, et des règles `mod_expires` obsolètes provenant d'un ancien hébergeur sont une source fréquente de comportement de cache déroutant.
5. **Tout ce qu'une extension a écrit.** Ignorez-le. Réinstallez l'extension sur le nouveau site et laissez-la faire son travail.

Votre migration conserve le fichier lui-même, donc rien n'est perdu pendant que vous parcourez la liste. Guide complet de migration : [Migrer un site web depuis cPanel](https://support.kapsulehost.com/fr-fr/sites-migrate-cpanel).

## Dépannage

**« J'ai ajouté une redirection à .htaccess et rien ne s'est passé. »** C'est normal. Ajoutez-la dans **Paramètres**, puis **Redirections**. La colonne Status vous indique si la redirection a été vérifiée en direct.

**« Une extension dit que mon site est renforcé mais un scanner n'est pas d'accord. »** L'extension a écrit des règles `.htaccess` qui ne sont pas lues. Vérifiez l'onglet **Sécurité** du site pour connaître les protections réellement appliquées.

**« Le .htaccess de mon ancien hébergeur contenait des règles que je ne comprends pas. »** Ne les copiez pas à l'aveugle. Ouvrez un ticket avec le fichier joint et nous vous indiquerons lesquelles ont un équivalent KapsuleHost et lesquelles ne faisaient que compenser un hébergement Apache mutualisé.

**« Les permaliens sont cassés. »** Ce n'est pas un problème lié à `.htaccess` ici. Rendez-vous sur [Résoudre les problèmes de permaliens WordPress](https://support.kapsulehost.com/fr-fr/wordpress-permalink-issues), ou videz les règles de réécriture depuis l'onglet **WordPress** du site, puis **Actions rapides**, puis **Vider les redirections**.