Comment créer des redirections avec le module Redirect de Drupal ?

L'équipe Citead, mis à jour le

En bref. Créer une redirection dans URL redirects, saisir l’ancien chemin sans barre oblique initiale, définir la destination To, sélectionner le code Redirect status et enregistrer.

Définition : Une redirection envoie une requête adressée à une URL source vers une URL de destination. Le module Redirect de Drupal crée ces correspondances au moyen d’un formulaire d’administration comprenant un chemin source (Path), une destination (To) et un réglage du code de redirection (Redirect status).

Points clés

Au 17 octobre 2026, les instructions ci-dessous s’appuient sur la documentation et les définitions des formulaires de la version 8.x-1.13 du module.

Où créer une redirection et que saisir dans chaque champ ?

Une fois Redirect installé, les instructions du README commencent par son activation dans Administration > Extend. Dans URL redirects, le bouton Add redirect ouvre le formulaire de création. Les définitions des routes du module indiquent les chemins d’administration suivants :

/admin/config/search/redirect
/admin/config/search/redirect/add
/admin/config/search/redirect/settings

Le champ Path contient l’ancien chemin relatif à la racine du site, sans nom de domaine ni barre oblique initiale. L’implémentation du champ source affiche le schéma et l’hôte du site suivis de / avant la zone de saisie. Elle extrait aussi les paramètres de requête saisis après ? pour les stocker séparément dans les données de la source.

Le champ To contient la destination. Le README décrit la saisie d’un titre pour sélectionner un contenu existant, d’un chemin interne tel que /node/add ou d’une URL externe telle que http://example.com. La valeur <front> désigne la page d’accueil du site. Ces formats concernent la destination ; le champ source impose sa propre restriction sur la barre oblique.

La sélection du code dans Redirect status, suivie de l’enregistrement, crée la correspondance. L’implémentation du formulaire affiche « The redirect has been saved. » et revient à la liste des redirections.

Quel code de redirection choisir ?

Un code de statut décrit la réponse HTTP envoyée pour l’ancienne adresse. La RFC 9110, HTTP Semantics, définit 301 Moved Permanently pour une ressource à laquelle une nouvelle adresse permanente est attribuée et 302 Found pour une ressource temporairement disponible à une autre adresse. Un déplacement permanent appelle donc un code 301 ; une redirection temporaire appelle un code 302.

Le code du formulaire Redirect sélectionne le code enregistré pour une redirection existante, lorsqu’il est présent, et utilise sinon la valeur par défaut configurée. Le formulaire de configuration présente ce réglage du site sous le libellé Default redirect status. Vérifier le sélecteur de chaque redirection avant l’enregistrement permet d’expliciter la réponse attendue.

Que vérifier après l’enregistrement ?

Une vérification pratique commence par une requête vers l’ancienne adresse et l’examen du code de statut et de la destination de sa réponse. Les définitions des redirections de la RFC 9110 précisent que l’en-tête de réponse Location indique la destination des réponses 301 et 302. Le résultat attendu associe le code choisi à la destination prévue.

Les paramètres de requête nécessitent une vérification distincte lorsque les anciens liens en contiennent. Le formulaire de configuration propose l’option Retain query string through redirect, qui conserve la chaîne de requête lors de la redirection. Dans son exemple, source-path?a=alligators&b=bananas mène à node?a=apples&b=bananas lorsque la destination configurée est node?a=apples : pour un paramètre commun, la valeur de la destination est prioritaire.

Termes associés

Questions fréquentes

Puis-je rediriger vers un autre site web ?

Oui. Le README de Redirect accepte une URL externe dans To et donne http://example.com comme exemple.

Pourquoi mon chemin source échoue-t-il à la validation ?

Vérifiez si vous avez saisi une barre oblique / initiale, un fragment d’ancre ou <front>. La validation du formulaire refuse chacune de ces valeurs sources et vérifie aussi si la redirection renvoie vers la même page.

Puis-je créer automatiquement des redirections lorsque les alias changent ?

Oui. Dans le formulaire de configuration, vous pouvez activer Automatically create redirects when URL aliases are changed. pour créer automatiquement des redirections lors des changements d’alias d’URL. Ce réglage est désactivé lorsque le module Path de Drupal est absent.

Sources

  1. Projet Drupal Redirect, « README.txt », version 8.x-1.13, sans date
  2. Projet Drupal Redirect, « RedirectForm.php », version 8.x-1.13, sans date
  3. Projet Drupal Redirect, « redirect.settings.yml », version 8.x-1.13, sans date
  4. Projet Drupal Redirect, « redirect.routing.yml », version 8.x-1.13, sans date
  5. Projet Drupal Redirect, « RedirectSourceWidget.php », version 8.x-1.13, sans date
  6. Projet Drupal Redirect, « RedirectSettingsForm.php », version 8.x-1.13, sans date
  7. IETF, « RFC 9110: HTTP Semantics », juin 2022

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Testez une page et voyez quoi corriger en premier

L'analyse prend en général moins de 10 secondes et ne demande pas de compte.

400 000+ pages notées dans le benchmark public