Redirections

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

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

Mises à jour des environnements Pro

Redirections tout-itinéraire

À l’aide de redirections d’itinéraire, vous pouvez définir des itinéraires simples à l’aide du fichier routes.yaml. Par exemple, vous pouvez rediriger d’un domaine d’application 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 aux itinéraires existants en fonction de la correspondance de 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 n’importe quel type d’itinéraire, y compris les itinéraires desservis directement par l’application.

Deux clés sont disponibles sous redirects :

Exemples de redirections à itinéraire partiel

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

Correspondance de modèle d’expression régulière

Utilisez le format suivant pour configurer les demandes de redirection basées sur 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 de requête 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 du modèle de préfixe

Utilisez le format suivant pour configurer les demandes 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 de motifs 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 l’heure 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 :