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.
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.
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.
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
- Connectez-vous à KPanel et cliquez sur Sites web dans la barre latérale gauche.
- Cliquez sur le site souhaité.
- Ouvrez l'onglet WordPress, puis la section wp-config.
- 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
- Ouvrez le site, puis Paramètres, puis Gestionnaire de fichiers.
- 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
.htaccessn'apparaîtra pas tant que vous n'aurez pas fait cela. - Cliquez sur
.htaccesspour 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.
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.
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 :
# 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 :
- Redirections. Recréez chaque
RedirectouRewriteRuledans Paramètres, puis Redirections. Une ligne par règle. Choisissez 301 pour un déplacement permanent, 302 si le changement pourrait être inversé. - Forçage HTTPS. Supprimez-le. Activez plutôt Forcer HTTPS dans les Paramètres du site.
- Blocages d'IP. Recréez-les dans WordPress, puis Sécurité, dans le panneau de blocage d'IP.
- En-têtes de mise en cache et de compression. Supprimez-les. Ils sont pris en charge automatiquement, et des règles
mod_expiresobsolètes provenant d'un ancien hébergeur sont une source fréquente de comportement de cache déroutant. - 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.
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, ou videz les règles de réécriture depuis l'onglet WordPress du site, puis Actions rapides, puis Vider les redirections.