# Redirections de site

Source: https://support.kapsulehost.com/fr-fr/site-redirects

Les redirections envoient les visiteurs d'une ancienne URL vers une nouvelle, ce qui permet de restructurer un site sans casser tous les liens qui pointent vers lui. Ce guide couvre les trois formes de source, le choix entre 301 et 302, les chaînes de requête, et la lecture du badge de vérification.

## Où se trouvent les redirections dans KPanel

1. Connectez-vous à [KPanel](https://kpanel.kapsulehost.com).
2. Cliquez sur **Sites web** dans la barre latérale gauche, puis cliquez sur le site.
3. Dans le menu gauche du site, ouvrez **Paramètres**, puis **Redirections**.

L'adresse directe est `/websites/<site-id>/redirects`.

![Redirections pour un site dans KPanel](https://support.kapsulehost.com/help/screenshots/site-redirects.243dc02e.webp)

Les redirections ici sont appliquées par le serveur web, avant que votre application ne s'exécute. Cela les rend plus rapides qu'une redirection basée sur un plugin et signifie qu'elles fonctionnent même pour des URL que votre application ne reconnaîtrait pas du tout.

## Ajouter une redirection

1. Cliquez sur **Ajouter une redirection**.
2. Saisissez le **Chemin source**.
3. Saisissez la **Destination**.
4. Choisissez **301 Permanent** ou **302 Temporaire**.
5. Décidez si vous souhaitez conserver **Préserver la chaîne de requête** coché.
6. Cliquez sur **Ajouter une redirection**.

La redirection est appliquée puis vérifiée directement sur votre site, de sorte que le statut affiché reflète un comportement réel plutôt qu'une supposition.

## Les trois formes de source

| Forme | Exemple | Correspondances |
|---|---|---|
| Exacte | `/old-page` | Ce seul chemin |
| Préfixe | `/old-path/` | Ce chemin et tout ce qui se trouve en dessous |
| Générique | `/blog/*` | Tout ce qui se trouve sous `/blog/`, en capturant le reste |

Une source générique capture ce qui correspondait au `*`, et la destination peut y faire référence sous la forme `$1`. Ainsi, une source `/blog/*` avec une destination `/news/$1` envoie `/blog/hello-world` vers `/news/hello-world`, et fait de même pour chaque autre article, à partir d'une seule règle.

> **Note:** Le chemin source ne peut pas être modifié une fois la redirection créée. Si vous vous êtes trompé, supprimez la redirection et ajoutez-en une nouvelle. La destination, le code et le paramètre de requête sont tous modifiables.

## Destinations

Une destination peut être soit :

- **Relative**, comme `/new-page`, pour envoyer les visiteurs ailleurs sur le même site.
- **Absolue**, comme `https://example.com/new`, pour les envoyer vers un autre site entièrement.

Les destinations absolues permettent de créer des chemins personnalisés : `/docs` sur votre domaine pointant par exemple vers une documentation hébergée ailleurs.

## 301 ou 302

**301 Permanent** indique aux navigateurs et aux moteurs de recherche que le déplacement est définitif. Les moteurs de recherche transfèrent les signaux de classement vers la nouvelle URL et cessent de demander l'ancienne. Les navigateurs mettent la redirection en cache, parfois très longtemps.

**302 Temporaire** indique que le déplacement pourrait être annulé. Rien n'est transféré et rien n'est mis en cache à long terme.

Utilisez le 301 pour une véritable restructuration : vous avez déplacé une page et elle ne reviendra pas. Utilisez le 302 pour tout ce que vous prévoyez d'annuler, comme pointer une page vers une campagne temporaire ou un avis de maintenance.

> **Warning:** Un 301 erroné est coûteux à annuler. Les navigateurs mettent agressivement en cache les redirections permanentes, de sorte qu'un visiteur ayant une fois rencontré la mauvaise règle peut continuer à la suivre longtemps après que vous l'avez supprimée, sans aucun moyen pour vous de vider son cache. En cas de doute, commencez par un 302 et passez au 301 une fois certain.

## Préserver la chaîne de requête

**Préserver la chaîne de requête** est activé par défaut. Lorsque c'est le cas, `?utm_source=newsletter` et tout autre paramètre sont transmis jusqu'à la destination.

Laissez cette option activée dans presque tous les cas. Perdre les chaînes de requête casse le suivi des campagnes, casse la pagination et les filtres, et casse tout lien qui transporte un état. La liste des redirections marque toute règle où cette option est désactivée par `(query stripped)`, afin que vous puissiez voir d'un coup d'œil lesquelles suppriment les paramètres.

Désactivez-la uniquement lorsque la destination ne doit jamais recevoir les anciens paramètres, par exemple lorsque les anciens paramètres seraient interprétés différemment et provoqueraient l'affichage de la mauvaise page.

## Lire le badge de statut

Après chaque enregistrement, la redirection est testée directement sur votre site, et non via un cache, et le résultat devient le badge affiché dans la colonne **Status**.

| Badge | Signification |
|---|---|
| Pas encore vérifié | La vérification n'a pas encore été effectuée. Actualisez dans un instant |
| Vérifié, avec le code et la destination | La redirection est active et fait exactement ce que vous avez configuré |
| Appliquée mais non contestée, avec un statut | La règle a été écrite mais le site a renvoyé autre chose |

Le troisième badge est celui sur lequel il faut agir. Il signifie que la configuration est en place mais que la redirection ne prend pas effet, et le code de statut affiché vous indique ce qui s'est passé à la place.

Vous pourriez également voir un avertissement après l'enregistrement indiquant qu'une autre configuration sur le serveur revendique le même domaine. Dans ce cas, la redirection ne s'appliquera pas tant que ce conflit n'est pas résolu, et le message nomme l'autre configuration. Contactez le support si vous le voyez et n'êtes pas sûr de sa signification.

## Modifier et supprimer

Chaque ligne dispose d'un bouton de modification et d'un bouton de suppression.

La modification vous permet de changer la destination, le code et le paramètre de requête. La source est fixe.

La suppression demande une confirmation et explique ce qui va se passer : les requêtes vers ce chemin cessent d'être redirigées et renvoient ce que le site sert normalement à cet endroit, ce qui correspond souvent à une 404.

## Planifier une restructuration

Avant de déplacer un grand nombre d'URL, un peu d'ordre vous épargne beaucoup de souffrance.

1. **Exportez votre liste d'URL actuelle** depuis votre plan de site ou vos statistiques, afin de savoir ce qui génère réellement du trafic.
2. **Associez l'ancien au nouveau**, une ligne par URL. Regroupez tout ce qui partage un préfixe.
3. **Utilisez des règles génériques pour les groupes.** Une seule règle `/blog/*` vaut mieux que deux cents règles exactes et ne se dérèglera pas avec le temps.
4. **Ajoutez des règles exactes pour les exceptions** qui ne suivent pas le schéma.
5. **Testez chaque forme une fois**, puis vérifiez les badges.
6. **Surveillez ensuite votre nombre d'erreurs 4xx** dans [Statistiques de trafic du site](https://support.kapsulehost.com/fr-fr/site-analytics). Une part croissante de 404 signifie que vous avez manqué quelque chose.

> **Tip:** Ajoutez une page 404 personnalisée comme filet de sécurité pour ce que vous auriez manqué. Cela transforme une impasse en un chemin de retour vers le site. Voir [Pages d'erreur personnalisées](https://support.kapsulehost.com/fr-fr/site-error-pages).

## Dépannage

**La redirection ne se déclenche pas.** Vérifiez le badge. S'il indique appliquée mais non contestée, notez le code de statut renvoyé. Un 200 signifie généralement qu'autre chose a répondu à la requête en premier, souvent l'application elle-même.

**Elle se déclenche mais j'arrive sur la mauvaise URL.** Vérifiez s'il y a une chaîne : votre règle peut envoyer le trafic vers un chemin qu'une autre règle, ou l'application, redirige à nouveau. Les chaînes sont lentes et perturbent les moteurs de recherche. Faites pointer la première règle directement vers la destination finale.

**Une règle générique envoie tout vers une seule page.** La destination n'a pas son `$1`. Sans cela, chaque capture s'effondre sur la même cible.

**Une redirection que j'ai supprimée se produit toujours dans mon navigateur.** Vous avez précédemment suivi un 301 et votre navigateur l'a mis en cache. Testez dans une fenêtre privée pour confirmer que la règle a bien disparu.

**Les paramètres de requête disparaissent.** **Préserver la chaîne de requête** est désactivé sur cette règle. Modifiez-la et réactivez l'option.

**Trop de redirections, ou une boucle.** Deux règles pointent l'une vers l'autre, ou une règle pointe vers un chemin qui correspond à son propre modèle de source. Supprimez un côté de la boucle.

## Pages connexes

- [Pages d'erreur personnalisées](https://support.kapsulehost.com/fr-fr/site-error-pages) pour ce que voient les visiteurs lorsque rien ne correspond.
- [Statistiques de trafic du site](https://support.kapsulehost.com/fr-fr/site-analytics) pour surveiller les nombres de 3xx et de 4xx après une restructuration.
- [Protéger un site par mot de passe](https://support.kapsulehost.com/fr-fr/site-password-protect) pour verrouiller un chemin plutôt que de le déplacer.