Manuel utilisateur
Version 1.9 — Rev. 3

# 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;
  > MapSource: chemin de fichier vers un fichier ASCII brut valide.

  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 "#".
- Texte brut aléatoire

  > MapType: rnd;
  > MapSource: chemin de fichier d’un fichier ASCII brut valide.

  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.
- Fonction interne

  > MapType: int;
  > MapSource: fonction de chaîne interne

  4 fonctions sont disponibles:
  - 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.

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 rewrite map, consultez la documentation mod_rewrite d’Apache.

#### 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