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.
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.
Important : 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.
A confirmer
[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 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 le traitement souhaité (suppression ou conservation) des paramètres d'URL ;
Validez la création en cliquant sur le bouton "Ajouter" ;
La nouvelle règle créée est ajoutée à la fin de la liste des règles de réécriture.
Important : 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
Important : 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 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 le traitement souhaité (suppression ou conservation) des paramètres d'URL.
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 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.