mod_rewrite(4gx)

Name
mod_rewrite — http(8gx) handler for altering HTTP request URIs before processing

Description
mod_rewrite can alter request URIs. It runs before any of the other built-in or HTTP processing modules.

Configuration directives
This component shares http.cfg. See http(8gx).

Rewrite map
The filemap that specifies which URIs to handle is rewrite.txt, which is searched for in config_file_path. The usual location is /etc/gromox/rewrite.txt.

Each line in this file consists of 3 columns separated by whitespace:

•   A POSIX Basic Regular Expression (cf. regcomp(3)) for matching the original URI. For safety, this should always be anchored with the beginning-of-line metacharacter (^; circumflex).

•   The fixed sequence "=>".

•   Replacement string. Captures can be spliced using \1, \2, etc. The sequence \0 splices the entire string (equivalent of Perl's $&). If a particular pattern has successfully matched, no other rewrite rules are processed.

If the file has no lines, no paths will be rewritten. If the file is absent however, a set of default entries will be used.

Default rules
^/Microsoft-Server-ActiveSync\(/\|$\) => /sync/index.php

Examples
^/\([a-z+]\)/\([a-z]+\).txt$ => /\2/\1.txt

Files

•   config_file_path/rewrite.txt: Map specifying how to rewrite URIs

See also
gromox(7), http(8gx)