Manual de usuario
Version 1.9 — Rev. 3

# Rewrite

### Habilitar rewrite

#### Descripción

Especifica si se habilita el motor de reescritura de URL de LiteSpeed. Esta opción puede personalizarse a nivel de virtual host o contexto, y se hereda a lo largo del árbol de directorios hasta que se sobrescribe explícitamente.

#### Sintaxis

Seleccionar desde botones de opción

### Carga automatica desde .htaccess

#### Descripción

Carga automaticamente reglas rewrite contenidas en el archivo .htaccess de un directorio al acceder por primera vez a ese directorio si aun no existe un HttpContext para ese directorio que use la directiva rewritefile. Una vez cargado inicialmente, debe realizarse un reinicio graceful para que cualquier cambio posterior en ese archivo .htaccess tenga efecto.
La opcion de nivel Virtual Host reemplaza la opcion de nivel Servidor. Valores predeterminados:
Nivel Servidor: No
Nivel VH: Heredar configuracion de nivel Servidor

#### Sintaxis

Seleccionar desde botones de opción

### Nivel de registro

#### Descripción

Especifica el nivel de detalle de la salida de depuración del motor de reescritura. Este valor va de 0 a 9. 0 deshabilita el registro. 9 produce el registro más detallado. El registro de errores del servidor y del virtual host Nivel de registro debe configurarse al menos en INFO para que esta opción tenga efecto. Es útil al probar reglas de reescritura.

#### Sintaxis

Número entero

#### Ver también

Server Nivel de registro, Virtual Host Nivel de registro

### Nombre

#### Descripción

Especifica un nombre único para el rewrite map a nivel de virtual host. Este nombre será usado por una referencia de mapeo en las reglas de reescritura. Al referenciar este nombre, debe usarse una de las siguientes sintaxis:

> `$\{MapName:LookupKey\}
> $\{MapName:LookupKey|DefaultValue\}`

La implementación del motor de reescritura de LiteSpeed sigue las especificaciones del motor de reescritura de Apache. Para más detalles sobre rewrite maps, consulte documentación mod_rewrite de Apache.

#### Sintaxis

cadena

### Ubicación

#### Descripción

Especifica la ubicación del rewrite map usando la sintaxis MapType:MapSource.
El motor de reescritura de LiteSpeed admite tres tipos de rewrite maps:

- Texto plano estándar

  > MapType: txt;
  > MapSource: ruta de archivo a un archivo ASCII plano válido.

  Cada línea de este archivo debe contener dos elementos separados por espacios en blanco. El primer elemento es la clave y el segundo es el valor. Se pueden agregar comentarios con un signo inicial "#".
- Texto plano aleatorizado

  > MapType: rnd;
  > MapSource: ruta de archivo de un archivo ASCII plano válido.

  El formato del archivo es similar al de texto plano estándar, excepto que el segundo elemento puede contener varias opciones separadas por un signo "|" y elegidas aleatoriamente por el motor de reescritura.
- Función interna

  > MapType: int;
  > MapSource: función interna de cadena

  Hay 4 funciones disponibles:
  - toupper: convierte la clave de búsqueda a mayúsculas.
  - tolower: convierte la clave de búsqueda a minúsculas.
  - escape: aplica codificación URL a la clave de búsqueda.
  - unescape: aplica decodificación URL a la clave de búsqueda.
Los siguientes tipos de mapa disponibles en Apache no se han implementado en LiteSpeed:
Hash File y External Rewriting Program.

La implementación del motor de reescritura de LiteSpeed sigue las especificaciones del motor de reescritura de Apache. Para más detalles sobre rewrite map, consulte documentación mod_rewrite de Apache.

#### Sintaxis

Cadena

### Reglas de reescritura

#### Descripción

Especifica una lista de reglas de reescritura a nivel de virtual host.
NO agregue aquí reglas de reescritura de nivel de raíz de documentos. Si tiene reglas de reescritura de nivel de raíz de documentos desde .htaccess, debe crear en su lugar un contexto estático con uri "/" y agregar allí las reglas de reescritura.
Una regla de reescritura consta de una directiva RewriteRule y, opcionalmente, puede ir precedida por varias directivas RewriteCond.

- Cada directiva debe ocupar una sola línea.
- RewriteCond y RewriteRule siguen la sintaxis de directivas rewrite de Apache. Simplemente copie y pegue directivas rewrite desde sus archivos de configuración de Apache.
- Hay pequeñas diferencias entre las implementaciones de LiteSpeed y Apache mod_rewrite:
  - %\{LA-U:variable\} y %\{LA-F:variable\} son ignoradas por el motor de reescritura de LiteSpeed
  - Se agregan dos nuevas variables de servidor al motor de reescritura de LiteSpeed: %\{CURRENT_URI\} representa la URI actual que procesa el motor de reescritura y %\{SCRIPT_NAME\} tiene el mismo significado que la variable de entorno CGI correspondiente.
  - El motor de reescritura de LiteSpeed dejará de procesar reglas de reescritura después de encontrar una marca [L] para evitar bucles, mientras que Apache mod_rewrite dejará de procesar reglas de reescritura solo para la iteración actual. Este comportamiento es similar al de la marca [END] en Apache mod_rewrite.

La implementación del motor de reescritura de LiteSpeed sigue las especificaciones del motor de reescritura de Apache. Para más detalles sobre las reglas de reescritura, consulte documentación mod_rewrite de Apache y guía de reescritura de URL de Apache .

#### Sintaxis

cadena