Comprendre .htaccess sur KapsuleHost

Kapsule fonctionne 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 paramètre KPanel qui fait chaque tâche à la place.

Si vous avez migré depuis un hébergement partagé cPanel, .htaccess était probablement l'endroit où vous mettiez les redirections, le forçage HTTPS, les pages d'erreur personnalisées et les blocs de bot. Toutes ces choses fonctionnent toujours sur Kapsule. Elles sont simplement définies dans KPanel plutôt que dans un fichier texte, et parce qu'elles sont appliquées au niveau du serveur, elles sont plus rapides et ne peuvent pas casser votre site avec 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 et aussi ce qui le rend lent.

Kapsule n'utilise pas 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 est une grande partie de la raison pour laquelle les sites ici réagissent plus rapidement sous charge. Ce serveur n'a pas d'équivalent à un fichier de remplacement par répertoire, il n'ouvre donc jamais .htaccess.

La bonne nouvelle est l'inverse de l'histoire habituelle d'.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

Permaliens. La raison la plus courante pour laquelle un site WordPress a besoin d'.htaccess sur Apache est les permaliens jolis. Sur Kapsule, la réécriture est intégrée à la configuration du serveur de votre site, donc /2026/07/my-post/ se résout via WordPress sans bloc .htaccess du tout. Si les permaliens retournent des erreurs 404, la cause est quelque chose d'autre : consultez Corriger les problèmes de permalien WordPress.

WordPress écrivant dans le fichier. WordPress et certains plugins écrivent toujours des blocs # BEGIN/# END dans .htaccess parce qu'ils supposent Apache. C'est inoffensif. Le fichier est réel, il est inscriptible, et vous le verrez dans le gestionnaire de fichiers. Il n'a simplement pas de lecteur.

Plugins de sécurité qui signalent « durcissement appliqué ». Les plugins qui prétendent avoir verrouillé xmlrpc.php ou wp-config.php en modifiant .htaccess n'ont en fait rien protégé sur cette plateforme. Utilisez l'onglet Security du site, qui applique les règles équivalentes au serveur.

Équivalents KPanel pour les règles .htaccess courantes

Chacun d'eux se trouve sur le site lui-même : Websites, puis votre site, puis l'onglet indiqué.

Deux de ces options font plus que la version .htaccess n'a jamais pu faire. Les redirections supportent les chemins exacts, les préfixes de barre oblique de fin et les caractères génériques tels que /blog/*, et KPanel vérifie la redirection en direct après l'avoir enregistrée. Les pages d'erreur sont servies avec leur véritable code d'état, donc une page 404 personnalisée est toujours un vrai 404 pour les moteurs de recherche plutôt qu'un 200 avec des excuses.

Trouver et lire le fichier

Vous pouvez toujours vouloir regarder .htaccess, généralement pour voir ce qu'un plugin y a écrit ou pour copier les règles avant de les recréer dans KPanel.

À partir de l'onglet WordPress

1. Connectez-vous à KPanel et cliquez sur Websites dans la barre latérale gauche.
2. Cliquez sur le site que vous souhaitez.
3. Ouvrez l'onglet WordPress, puis la section wp-config.
4. Faites défiler jusqu'au panneau .htaccess. Le contenu est affiché en lecture seule, avec un bouton Edit si vous avez besoin de le modifier.

À partir du gestionnaire de fichiers

1. Ouvrez le site, puis Files, puis File Manager.
2. Cliquez sur Show Hidden 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 ne le ferez pas.
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. Les détails complets sur l'éditeur et ses contrôles de permissions se trouvent dans Using the File Manager.

Le bloc WordPress par défaut

Pour référence, c'est le bloc que WordPress écrit pour lui-même. Sur un hôte Apache, il pilote les permaliens. Sur Kapsule, 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 pourriez déplacer le site vers un hôte Apache plus tard. WordPress le récrira de toute façon la prochaine fois que vous enregistrerez vos paramètres de permalien.

Si vous migrez les règles

Lorsque vous apportez un site à partir de cPanel, ouvrez l'ancien .htaccess avant d'annuler l'ancien hébergement et travaillez-le ligne par ligne :

1. Redirections. Recréez chaque Redirect ou RewriteRule dans Advanced, puis Redirects. 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 Force HTTPS dans les Settings du site.
3. Blocs IP. Recréez dans WordPress, puis Security, dans le panneau de blocage IP.
4. En-têtes de mise en cache et de compression. Supprimez-les. Ils sont gérés pour vous, et les règles mod_expires obsolètes d'un ancien hôte sont une source courante de comportement de cache confus.
5. Tout ce qu'un plugin a écrit. Ignorez-le. Réinstallez le plugin sur le nouveau site et laissez-le faire son propre travail.

Votre migration conserve le fichier lui-même, donc rien n'est perdu pendant que vous travaillez à travers la liste. Procédure de migration complète : Migrating a Website From cPanel.

Dépannage

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

« Un plugin dit que mon site est durci mais un scanner n'est pas d'accord. » Le plugin a écrit des règles .htaccess qui ne sont pas en cours de lecture. Consultez l'onglet Security du site pour les protections qui sont réellement appliquées.

« L'ancien .htaccess de mon hôte contenait des règles que je ne comprends pas. » Ne les copiez pas aveuglément. Ouvrez un ticket avec le fichier joint et nous vous dirons lesquelles ont un équivalent Kapsule et lesquelles ne faisaient que compenser un hôte Apache partagé.

« Les permaliens sont cassés. » Ce n'est pas un problème .htaccess ici. Allez à Fixing WordPress Permalink Issues, ou videz les règles de réécriture à partir de l'onglet WordPress du site, puis Quick Actions, puis Flush Rewrites.