Vous pouvez faciliter l'accès à vos ressources exposées grâce à des règles de réécriture.
Les règles de réécriture permettent à vos utilisateurs de manipuler des URL plus simples sans dégrader votre référencement ou vous demander de refondre l'architecture de votre plateforme.
Dans cet article, vous apprendrez comment :
Pour commencer...
Une règle de réécriture Baleen se caractérise par :
un pattern à réécrire (au format PCRE) permettant de définir le déclencheur de la réécriture;
un pattern de réécriture (au format PCRE) utilisé pour définir la nouvelle valeur des URL à réécrire;
une gestion des paramètres d'URL (query string) : information permettant d'indiquer le traitement (suppression/conservation) des paramètres d'URL existants.
Tout changement de configuration impacte le trafic de votre plateforme en quelques secondes.
Consulter les règles de réécriture
L'ensemble des règles de réécriture existantes sont accessibles depuis le menu par le chemin :
Accélérez votre site > Gestion du trafic > Règles de réécriture
Les règles de réécriture existantes sont restituées sous forme de liste.
Pour chaque règle de la liste, les informations suivantes sont restituées :
le pattern à réécrire
le pattern de réécriture
le traitement des paramètres d'URL
A tout moment, la liste de règles peut être réduite par une recherche sur le pattern à réécrire ou le pattern de réécriture et par un filtre sur le traitement des paramètres d'URL.
L'ordre de la liste est déterminant dans l'exécution des réécriture et dans le résultat observé par les utilisateurs.
Par défaut, les règles sont triées par ordre croissant en considérant leur date de création.
Cet ordre peut être modifié en glissant-déposant une règle à son nouvel emplacement dans la liste.
Ajouter une règle de réécriture
Pour ajouter une règle de réécriture :
Cliquez sur le bouton “Créer une règle” accessible depuis la liste des règles de réécriture existantes.
Saisissez le pattern d'URL à réécrire (au format PCRE) permettant de définir le pattern qui déclenchera la réécriture ;
Saisissez le pattern de réécriture (au format PCRE) ;
Indiquez si vous souhaitez conserver les paramètres d'URL de la source de la redirection ;
Validez la création en cliquant sur le bouton "Créer cette règle" ;
La nouvelle règle créée est ajoutée à la fin de la liste des règles de réécriture.
Si une URL matchent deux règles de redirection, c’est la redirection dont la source est la plus précise qui est exécutée.
Exemple
Règle de réécriture A configurée dans Baleen:
Pattern source : /rewrite_rules/(.*)
Pattern de réécriture: /global/rewrite/$1
Règle de réécriture B configurée dans Baleen:
Pattern source : /rewrite_rules/script/js/(.*)
Pattern de réécriture: /script/rewrite/$1
>> Comportement observé dans le navigateur:
URL Saisie : https://mywebsite.com/rewrite_rules/script/js/main.js
Résultat : https://mywebsite.com/script/rewrite/main.js
L'ordre de la liste est déterminant pour l'exécution des redirections et pour le résultat observé par les utilisateurs.
Pourquoi conserver les paramètres d'URL ?
Les paramètres d'URL (communément appelés query string) représentent l'ensemble des données de type clé-valeur transmises dans une URL après le caractère '?'.
Exemple : dans l'URL, https://www.mydomain.com?page=1&chapter=3, la chaîne de caractère 'page=1&chapter=3' représente les paramètres d'URL.
Lorsqu'une URL avec des paramètres est réécrite après avoir matchée une règle de réécriture avec l'option "Conserver les paramètres d'URL", on retrouve les mêmes paramètres dans l'URL réécrite.
Ce choix est pertinent lorsque les traitements réalisés à partir de l'URL d'origine sont identiques à ceux réalisés à partir de l'URL réécrite et que les structures de données et les valeurs attendues sont les mêmes.
Exemples :
Exemple 1: Paramètres d'URL transmis
>> Règle de réécriture configurée dans Baleen:
Pattern source : /rewriting.html
Pattern de réécriture: /rewriting_with_qs.html
Conserver les paramètres d'URL : coché
>> Comportement observé dans le navigateur:
URL Saisie : https://mywebsite.com/rewriting.html?id=baleen
Résultat : https://mywebsite.com/rewriting_with_qs.html?id=baleen
Exemple 2 : Paramètres d'URL non transmis
>> Règle de réécriture configurée dans Baleen:
Pattern source : /rewriting.html
Pattern de réécriture: /rewriting_with_qs.html
Supprimer les paramètres d'URL : coché
>> Comportement observé dans le navigateur:
URL Saisie : https://mywebsite.com/rewriting.html?id=baleen
Résultat : https://mywebsite.com/rewriting_with_qs.html
Exemples de règles de réécriture
Réécriture simple
>> Règle de réécriture configurée dans Baleen
Pattern source : /url_rewriting/rules.html
Pattern de réécriture: /rewriting_rules.html
>> Comportement observé dans le navigateur
URL Saisie : https://mywebsite.com/url_rewriting/rules.html
Résultat : https://mywebsite.com/rewriting_rules.html
Réécriture avancée
>> Règle de réécriture configurée dans Baleen
Pattern source : /url_rewriting/.*\.js$
Pattern de réécriture: /js/script.js
>> Comportement observé dans le navigateur
URL Saisie : https://mywebsite.com/url_rewriting/script.js
Résultat : https://mywebsite.com/js/script.js
Réécriture complexe
>> Règle de réécriture configurée dans Baleen
Pattern source : \.([a-zA-Z]{2,4})$
Pattern de réécriture: /rewriting_extension.$1
>> Comportement observé dans le navigateur
URL Saisie : https://mywebsite.com/test.js
Résultat : https://mywebsite.com/rewriting_rules.js
Modifier une règle de réécriture
Pour modifier une règle de réécriture :
Cliquez sur le pictogramme “Modifier cette règle” de la règle de réécriture à modifier.
Modifiez les caractéristiques de la règle :
Saisissez le pattern à réécrire (au format PCRE) permettant de définir le pattern qui déclenchera la réécriture ;
Saisissez le pattern de réécriture ;
Indiquez si vous souhaitez conserver les paramètres d'URL de la source de la redirection
Validez les modifications apportées en cliquant sur le bouton "Modifier" ;
Les modifications apportées sur la règle sont visibles dans la liste des règles de réécriture.
Supprimer une règle de réécriture
Pour supprimer une règle de réécriture existante :
Cliquez sur le pictogramme “Supprimer cette règle” de la règle de réécriture à supprimer.
Confirmez la suppression de la règle
La règle supprimée n'apparaît plus dans la liste des règles de réécriture.
Il est possible de supprimer plusieurs règles de réécriture en les sélectionnant et en cliquant sur le pictogramme de suppression restitué dans le bandeau d'actions par lot.