En bref. La correspondance des sous-chemins (Subpath matching) détermine la correspondance, tandis que la conservation du suffixe du chemin (Preserve path suffix) détermine si la partie du chemin sans correspondance est ajoutée à la cible.

Définition : Dans les Bulk Redirects de Cloudflare, la correspondance des sous-chemins (Subpath matching) détermine si une requête vers un chemin situé sous un répertoire source correspond à la redirection. La conservation du suffixe du chemin (Preserve path suffix) détermine si la partie du chemin sans correspondance est ajoutée à l’URL cible. Lorsque les deux options sont activées, /my-folder/foo est redirigé vers /another-folder/foo.

Points clés

Le champ d’API subpath_matching est un booléen dont la valeur par défaut est false. Lorsqu’il vaut true, Cloudflare applique l’algorithme de correspondance des sous-chemins à l’URL de la requête. Cloudflare décrit ce comportement dans sa référence des paramètres de redirection d’URL.
Le champ d’API preserve_path_suffix est un booléen dont la valeur par défaut est true. Il s’applique uniquement lorsque la correspondance des sous-chemins est activée.
Lorsque les deux options sont activées, une redirection de /my-folder/ vers /another-folder/ envoie /my-folder/foo vers /another-folder/foo. Lorsque la conservation du suffixe du chemin est désactivée, la même requête correspond toujours à la redirection et mène à /another-folder/.
Le guide de correspondance des Bulk Redirects de Cloudflare indique que la correspondance des sous-chemins s’applique à tous les chemins situés sous le chemin source exact.
Lorsque la correspondance des sous-chemins est activée, le chemin de l’URL source ne peut pas contenir plus de 16 barres obliques.

Comment la correspondance des sous-chemins reconnaît-elle le chemin de la requête ?

Cloudflare compare le schéma, le nom d’hôte et le chemin de la requête à ceux de l’URL source. Le guide de correspondance précise que, par défaut, le chemin source doit correspondre exactement. Si la correspondance des sous-chemins est activée, Cloudflare prend également en compte les chemins situés sous ce chemin source. Une URL source https://example.com/foo/ et une URL cible https://example.com/qux/ correspondent donc à example.com/foo/bar et le redirigent vers https://example.com/qux/bar.

La correspondance et la construction de la cible relèvent de décisions distinctes. Activer la correspondance des sous-chemins permet à une requête vers un chemin plus profond de correspondre à la redirection. Cette option ne détermine pas à elle seule si le segment bar sans correspondance est copié dans la cible.

Que change la conservation du suffixe du chemin ?

La conservation du suffixe du chemin est le paramètre qui détermine le traitement, dans le chemin cible, de la partie que la correspondance des sous-chemins laisse en dehors du chemin source configuré. Cloudflare définit cette partie comme les éléments du chemin de l’URL source sans correspondance. Sa valeur par défaut est true : le suffixe est donc inclus lorsque la correspondance des sous-chemins est active.

{
  "source_url": "/my-folder/",
  "target_url": "/another-folder/",
  "subpath_matching": true,
  "preserve_path_suffix": true
}

Pour cette configuration, la correspondance documentée redirige /my-folder/foo vers /another-folder/foo. Passer preserve_path_suffix à false conserve la correspondance, mais produit /another-folder/. L’URL cible reste la base de destination configurée, et le suffixe de la requête sans correspondance est omis.

Comment l’URL finale de redirection est-elle déterminée ?

La référence des paramètres de Cloudflare indique que l’URL cible finale dépend de la conservation de la chaîne de requête (Preserve query string) et de la conservation du suffixe du chemin. La conservation de la chaîne de requête est un booléen distinct, dont la valeur par défaut est false, qui contrôle la chaîne de requête de la requête d’origine. Lorsque cette option est activée, Cloudflare utilise cette chaîne de requête d’origine et supprime toute chaîne de requête définie dans l’URL cible, y compris lorsque la requête d’origine n’en contient aucune.

Les Bulk Redirects sont évalués avant que Cloudflare envoie la requête au serveur d’origine. Le guide de correspondance précise qu’après l’exécution d’une action de redirection, Cloudflare n’effectue aucun traitement supplémentaire. Un test de chemin doit donc examiner à la fois le chemin source correspondant et le chemin cible complet, en tenant compte du paramètre de suffixe.

Termes associés

Questions fréquentes

La conservation du suffixe du chemin permet-elle à un chemin plus profond de correspondre ?

Non. La correspondance des sous-chemins détermine si un chemin tel que /my-folder/foo correspond à /my-folder/. La conservation du suffixe du chemin détermine ce qu’il advient de foo après cette correspondance.

Que se passe-t-il lorsque la conservation du suffixe du chemin vaut false ?

La requête vers un chemin plus profond correspond toujours lorsque la correspondance des sous-chemins est activée. Cloudflare la redirige vers le chemin cible configuré, sans y ajouter la partie du chemin qui n’a pas correspondu.

Quelles sont les valeurs par défaut ?

La correspondance des sous-chemins vaut false par défaut, et la conservation du suffixe du chemin vaut true par défaut. Le paramètre de suffixe s’applique lorsque la correspondance des sous-chemins est activée.

Sources

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

Comment les Bulk Redirects de Cloudflare conservent-ils le suffixe d’un répertoire correspondant ?