[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Redirections

La gestion des règles de redirection est une exigence courante pour les applications web, en particulier dans les cas où vous ne souhaitez pas perdre les liens entrants qui ont été modifiés ou supprimés au fil du temps.

Vous trouverez ci-dessous comment gérer les règles de redirection sur vos projets d’infrastructure cloud Adobe Commerce à l’aide du fichier de configuration routes.yaml. Si les méthodes de redirection décrites dans cette rubrique ne fonctionnent pas pour vous, vous pouvez utiliser la mise en cache des en-têtes pour faire la même chose.

Mises à jour des environnements Pro

Redirections de l’ensemble de l’itinéraire

En utilisant les redirections d’itinéraire complet, vous pouvez définir des itinéraires simples à l’aide du fichier routes.yaml. Par exemple, vous pouvez rediriger d’un domaine apex vers un sous-domaine www comme suit :

http://{default}/:
    type: redirect
    to: http://www.{default}/

Redirections d’itinéraire partiel

Dans le fichier .magento/routes.yaml, vous pouvez ajouter des règles de redirection partielles à des itinéraires existants en fonction de la correspondance des modèles :

http://{default}/:
    redirects:
        expires: 1d
        paths:
          "/from": { to: "http://example.com/" }
          "/regexp/(.*)/matching": { to: "http://example.com/$1", regexp: true }

Les redirections partielles fonctionnent avec tout type de route, y compris les routes desservies directement par l'application.

Deux clés sont disponibles sous redirects :

Exemples de redirections d’itinéraire partiel

Les exemples suivants montrent comment spécifier des redirections d’itinéraire partiel dans le fichier routes.yaml à l’aide de diverses options de configuration paths.

Correspondance de modèles d’expressions régulières

Utilisez le format suivant pour configurer les requêtes de redirection en fonction d’une expression régulière.

http://{default}/:
    type: upstream
    redirects:
      paths:
        "/regexp/(.*)/match": { to: "http://example.com/$1", regexp: true }

Cette configuration filtre les chemins d’accès aux requêtes par rapport à une expression régulière et redirige les requêtes correspondantes vers https://example.com. Par exemple, une requête vers https://example.com/regexp/a/b/c/match redirige vers https://example.com/a/b/c.

Correspondance de modèles de préfixe

Utilisez le format suivant pour configurer des requêtes de redirection pour les chemins commençant par un modèle de préfixe spécifié.

http://{default}/:
    type: upstream
    redirects:
      paths:
        "/from": { to: "https://{default}/to", prefix: true }

Cette configuration fonctionne comme suit :

Correspondance du modèle de suffixe

Utilisez le format suivant pour configurer les requêtes de redirection qui ajoutent le suffixe de chemin de la requête à la destination cible :

http://{default}/:
    type: upstream
    redirects:
      paths: "/from": { to: "https://{default}/to", append_suffix: false }

Cette configuration fonctionne comme suit :

Configuration du cache spécifique au chemin d’accès

Utilisez le format suivant pour personnaliser le temps de mise en cache d’une redirection à partir d’un chemin spécifique :

http://{default}/:
    type: upstream
    redirects:
    expires: 1d
      paths:
        "/from": { to: "https://example.com/" }
        "/here": { to: "https://example.com/there", expires: "2w" }

Cette configuration fonctionne comme suit :