Rewrite
Table des matières
Contrôle Rewrite
Maps Rewrite
Règles Rewrite
Activer rewrite
Description
Indique s’il faut activer le moteur de réécriture d’URL de LiteSpeed. Cette option peut être personnalisée au niveau hôte virtuel ou contexte, et elle est héritée le long de l’arborescence de répertoires jusqu’à être explicitement remplacée.
Syntaxe
Sélectionner avec les boutons radio
Chargement automatique depuis .htaccess
Description
Charge automatiquement les regles rewrite contenues dans le fichier .htaccess d’un repertoire lors du premier acces a ce repertoire si aucun HttpContext utilisant la directive rewritefile n’existe deja pour ce repertoire. Une fois charge initialement, un redemarrage graceful doit etre effectue pour que tout changement ulterieur de ce fichier .htaccess prenne effet.
Le parametre de niveau Hote virtuel remplace le parametre de niveau Serveur. Valeurs par defaut:
Niveau serveur: No
Niveau VH: heriter du parametre de niveau Serveur
Syntaxe
Sélectionner avec les boutons radio
Niveau de journalisation
Description
Indique le niveau de détail de la sortie de débogage du moteur de réécriture. Cette valeur va de 0 à 9. 0 désactive la journalisation. 9 produit le journal le plus détaillé. Le journal d’erreurs du serveur et de l’hôte virtuel Niveau de journalisation doit être défini au moins sur INFO pour que cette option prenne effet. C’est utile lors du test de règles de réécriture.
Syntaxe
Nombre entier
Voir aussi
Server Niveau de journalisation, Virtual Host Niveau de journalisation
Nom
Description
Indique un nom unique pour la rewrite map au niveau hôte virtuel. Ce nom sera utilisé par une référence de mappage dans les règles de réécriture. Pour référencer ce nom, utilisez l’une des syntaxes suivantes:
$\{MapName:LookupKey\}
$\{MapName:LookupKey|DefaultValue\} L’implémentation du moteur de réécriture LiteSpeed suit les spécifications du moteur de réécriture Apache. Pour plus de détails sur les rewrite maps, consultez la documentation mod_rewrite d’Apache.
Syntaxe
chaîne
Emplacement
Description
Indique l’emplacement de la rewrite map avec la syntaxe MapType:MapSource.
Le moteur de réécriture LiteSpeed prend en charge trois types de rewrite maps:
- Texte brut standard
MapType: txt;
Chaque ligne de ce fichier doit contenir deux éléments séparés par des espaces. Le premier élément est la clé et le second est la valeur. Des commentaires peuvent être ajoutés avec le signe initial "#".
MapSource: chemin de fichier vers un fichier ASCII brut valide. - Texte brut aléatoire
MapType: rnd;
Le format du fichier est similaire à celui du fichier texte brut standard, sauf que le second élément peut contenir plusieurs choix séparés par le signe "|" et sélectionnés aléatoirement par le moteur de réécriture.
MapSource: chemin de fichier d’un fichier ASCII brut valide. - Fonction interne
MapType: int;
4 fonctions sont disponibles:
MapSource: fonction de chaîne interne- toupper: convertit la clé de recherche en majuscules.
- tolower: convertit la clé de recherche en minuscules.
- escape: applique l’encodage URL à la clé de recherche.
- unescape: applique le décodage URL à la clé de recherche.
Les types de map suivants disponibles dans Apache ne sont pas implémentés dans LiteSpeed:
Hash File et External Rewriting Program.
Syntaxe
Chaîne
Règles de réécriture
Description
Indique une liste de règles de réécriture au niveau hôte virtuel.
N’ajoutez PAS ici de règles de réécriture au niveau racine des documents. Si vous avez des règles de réécriture au niveau racine des documents provenant de .htaccess, vous devez plutôt créer un contexte statique avec uri "/" et y ajouter les règles de réécriture.
Une règle de réécriture comprend une directive RewriteRule et peut être précédée, facultativement, de plusieurs directives RewriteCond.
- Chaque directive doit tenir sur une seule ligne.
- RewriteCond et RewriteRule suivent la syntaxe des directives rewrite d’Apache. Copiez-collez simplement les directives rewrite depuis vos fichiers de configuration Apache.
- Il existe de légères différences entre les implémentations LiteSpeed et Apache mod_rewrite:
- %\{LA-U:variable\} et %\{LA-F:variable\} sont ignorées par le moteur de réécriture LiteSpeed
- Deux nouvelles variables serveur sont ajoutées dans le moteur de réécriture LiteSpeed: %\{CURRENT_URI\} représente l’URI actuelle traitée par le moteur de réécriture, et %\{SCRIPT_NAME\} a la même signification que la variable d’environnement CGI correspondante.
- Le moteur de réécriture LiteSpeed arrête de traiter les règles de réécriture après avoir rencontré un indicateur [L] afin d’éviter les boucles, tandis qu’Apache mod_rewrite n’arrête le traitement des règles de réécriture que pour l’itération actuelle. Ce comportement est similaire à celui de l’indicateur [END] dans Apache mod_rewrite.
L’implémentation du moteur de réécriture LiteSpeed suit les spécifications du moteur de réécriture Apache. Pour plus de détails sur les règles de réécriture, consultez la documentation mod_rewrite d’Apache et le guide Apache de réécriture d’URL .
Syntaxe
chaîne