# DfRedirects — Redirections 301 et capture des 404 pour Shopware 6
> Installation, configuration et utilisation de DfRedirects : règles 301/302/410, wildcards et regex, journal des 404, suggestions de cible, import CSV et dépannage.
- Page:
- Langue: fr
- Mis à jour le: 2026-08-02
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dfredirects-shopware/index.md), [de](https://www.datafirefly.com/de/documentation/dfredirects-shopware/index.md), [es](https://www.datafirefly.com/es/documentation/dfredirects-shopware/index.md), [it](https://www.datafirefly.com/it/documentation/dfredirects-shopware/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfredirects-shopware/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfredirects-shopware/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfredirects-shopware/index.md)
- Index:
## Présentation
DfRedirects ajoute à Shopware 6 un véritable gestionnaire de redirections : règles 301, 302, 307, 308 et 410 avec correspondance exacte, wildcard ou expression régulière, capture automatique des erreurs 404 rencontrées par vos visiteurs, suggestions de cible par similarité d'URL et import CSV en masse. Le plugin fonctionne sur Shopware 6.5, 6.6 et 6.7 avec un seul et même ZIP.
## Installation
### Depuis l'administration
1. Rendez-vous dans **Extensions > Mes extensions**.
2. Cliquez sur **Téléverser une extension** et sélectionnez le fichier `DfRedirects-1.0.0.zip`.
3. Cliquez sur **Installer**, puis activez l'extension.
### En ligne de commande
```
bin/console plugin:refresh
bin/console plugin:install --activate DfRedirects
bin/build-administration.sh
bin/console cache:clear
```
La compilation de l'administration est **indispensable** : sans elle, le module DfRedirects n'apparaîtra pas dans le menu Contenus de votre back-office. En environnement de production, utilisez `bin/build-administration.sh` ; en développement, `./psh.phar administration:build` ou la commande équivalente de votre installation.
L'installation crée deux tables dédiées : `df_redirect` (vos règles de redirection) et `df_redirect_404` (le journal des URL introuvables).
## Configuration générale
Ouvrez **Extensions > Mes extensions > DfRedirects > Configurer**. Trois réglages sont disponibles :
- **Activer le journal des 404** : enregistre les URL introuvables rencontrées par vos visiteurs. Activé par défaut.
- **Motifs ignorés** : une entrée par ligne. Les URL correspondantes ne sont ni redirigées ni journalisées. Les jokers sont acceptés (par exemple `/api-legacy/*`) ; une simple chaîne suffit également, elle est recherchée dans l'URL.
- **Conserver la query string** : reporte les paramètres d'URL (par exemple `?utm_source=newsletter`) sur l'URL de destination. Activé par défaut, sans effet sur les réponses 410.
Les requêtes vers les ressources statiques sont ignorées d'office : dossiers système (médias, miniatures, bundles, thème) et extensions de fichiers courantes (images, CSS, JS, polices). Vous n'avez pas besoin de les déclarer dans les motifs ignorés.
## Créer une redirection
Le module se trouve dans le menu **Contenus > Redirections** de l'administration. Cliquez sur **Ajouter une redirection** et renseignez :
- **URL source** : le chemin à intercepter, relatif à la racine du canal de vente (par exemple `/anciens-produits/sneakers-cuir`).
- **URL cible** : le chemin ou l'URL absolue de destination. Ce champ est masqué pour le code 410.
- **Code HTTP** : 301 (permanent), 302 (temporaire), 307, 308 ou 410 (page définitivement supprimée).
- **Type de correspondance** : exact, wildcard ou regex (voir la section suivante).
- **Priorité** : ordre d'évaluation des motifs, du plus élevé au plus faible. Sans effet sur les correspondances exactes.
- **Canal de vente** : laissez vide pour appliquer la règle à toute la boutique, ou sélectionnez un canal précis.
- **Actif** : permet de désactiver une règle sans la supprimer.
## Les trois modes de correspondance
### Exact
L'URL source doit correspondre au chemin demandé. La présence ou l'absence de barre oblique finale est tolérée : `/ma-page` et `/ma-page/` déclenchent la même règle. C'est le mode à privilégier, il couvre la grande majorité des cas et reste le plus rapide.
### Wildcard
L'astérisque `*` capture n'importe quelle portion d'URL. Dans l'URL cible, un astérisque au même rang reprend la valeur capturée.
```
Source : /collection/ete-*
Cible : /nouveautes/*
/collection/ete-robes → /nouveautes/robes
/collection/ete-shorts → /nouveautes/shorts
```
### Regex
Pour les cas les plus fins, saisissez une expression régulière (sans délimiteurs) et référencez les groupes capturés dans la cible avec `$1`, `$2`, etc.
```
Source : ^/produit/([0-9]+)-(.+)$
Cible : /p/$2
```
Les expressions invalides sont refusées à l'enregistrement et à l'import : une règle cassée ne peut pas mettre votre boutique en erreur.
### Ordre d'évaluation
1. Correspondances exactes attachées au canal de vente courant.
2. Correspondances exactes globales.
3. Motifs wildcard et regex actifs, triés par priorité décroissante.
## Journal des 404
L'onglet **Journal des 404** liste toutes les URL introuvables rencontrées par vos visiteurs. Chaque entrée est dédupliquée : une même URL n'apparaît qu'une fois, avec son nombre d'occurrences, le référent de la dernière visite et la date du dernier passage. Triez par nombre d'occurrences pour traiter en priorité les URL cassées qui vous coûtent le plus de trafic.
Deux actions sont disponibles sur chaque ligne :
- **Créer une redirection** : ouvre le formulaire avec l'URL source pré-remplie et les suggestions de cible déjà chargées. Après enregistrement, la 404 est automatiquement marquée comme résolue.
- **Marquer comme résolu** : classe l'entrée sans créer de règle, par exemple pour une URL qui n'a jamais existé.
Un interrupteur **Afficher les résolus** permet de réafficher les entrées traitées.
## Suggestions de cible
Dès que vous saisissez une URL source, le plugin propose jusqu'à cinq destinations classées par score de similarité. Le calcul compare le dernier segment de l'URL cassée à vos URL SEO canoniques : un pré-filtre en base restreint le champ des candidats, puis un score de proximité textuelle les classe. Un clic sur une suggestion remplit le champ cible.
Les suggestions reposent sur les URL SEO canoniques et non supprimées de votre boutique. Si votre catalogue vient d'être modifié, régénérez les URL SEO de Shopware avant de vous appuyer sur les scores.
## Import CSV
Le bouton **Importer** ouvre une fenêtre acceptant soit un fichier, soit un collage direct. Le format attendu comporte cinq colonnes :
```
source;cible;code;type;actif
/ancienne-page;/nouvelle-page;301;exact;1
/collection/ete-*;/nouveautes/*;301;wildcard;1
/produit-supprime;;410;exact;1
```
- **Délimiteur** : point-virgule ou virgule, détecté automatiquement.
- **Ligne d'en-tête** : optionnelle, elle est ignorée si elle est détectée.
- **Colonnes 3 à 5** : facultatives. Par défaut, code 301, type exact, règle active.
- **Type** : déduit automatiquement si la source contient un astérisque.
- **Codes acceptés** : 301, 302, 307, 308 et 410. La cible peut rester vide pour un 410.
L'import fonctionne en mise à jour : une règle existante portant la même URL source est mise à jour plutôt que dupliquée. Les règles importées sont créées en portée globale (tous canaux). À la fin, le plugin affiche le nombre de lignes créées, mises à jour et ignorées, avec le détail des erreurs rencontrées.
## Suivi des performances
Chaque règle compte ses déclenchements et mémorise la date du dernier passage. Une règle restée à zéro pendant plusieurs mois peut souvent être archivée ; à l'inverse, une règle très sollicitée signale une ancienne URL toujours largement diffusée, qu'il peut être utile de faire corriger à la source (backlink, campagne, catalogue papier).
## Dépannage
### Le module n'apparaît pas dans le menu Contenus
La compilation de l'administration n'a pas été exécutée après l'installation. Lancez `bin/build-administration.sh` puis videz le cache de votre navigateur.
### Une redirection ne se déclenche pas
1. Vérifiez que la règle est active et que son canal de vente correspond (ou qu'elle est globale).
2. Vérifiez que l'URL source est bien relative à la racine du canal : sur un canal servi depuis un sous-dossier, ne saisissez pas le préfixe du domaine.
3. Vérifiez qu'aucun motif ignoré ne couvre cette URL.
4. Videz le cache : `bin/console cache:clear`.
5. Assurez-vous qu'aucune redirection ne soit déjà appliquée en amont par votre serveur web ou votre CDN — dans ce cas, la requête n'atteint jamais Shopware.
### Le journal des 404 reste vide
Vérifiez que l'option **Activer le journal des 404** est cochée dans la configuration du plugin, et que vos motifs ignorés ne sont pas trop larges. Rappelez-vous que les ressources statiques sont exclues par conception.
### Une boucle de redirection
Elle survient lorsqu'une règle pointe vers une URL elle-même redirigée en retour, directement ou via un motif wildcard trop large. Recherchez l'URL cible dans la liste des sources et resserrez le motif fautif.
## Désinstallation
Lors de la désinstallation, Shopware propose de conserver les données. Si vous décochez cette option, les tables `df_redirect` et `df_redirect_404` sont supprimées définitivement, ainsi que toutes vos règles et l'historique des 404. Pensez à exporter vos règles avant si vous prévoyez une réinstallation.