- publishing free software manuals
The Apache HTTP Server Reference Manual
by Apache Software Foundation
Paperback (6"x9"), 862 pages
ISBN 9781906966034
RRP £19.95 ($29.95)

Get a printed copy>>>

3.72  Apache Module mod_substitute



Description:

Perform search and replace operations on response bodies

Status:

Extension

Module Identifier:

substitute_module

Source File:

mod_substitute.c

Compatibility:

Available in Apache 2.2.7 and later



Summary

mod_substitute provides a mechanism to perform both regular expression and fixed string substitutions on response bodies.

Directives:

Substitute

Substitute Directive

Description:

Pattern to filter the response content

Syntax:

Substitute s/pattern/substitution/[infq]

Context:

directory, .htaccess

Override:

FileInfo

Status:

Extension

Module:

mod_substitute

The Substitute directive specifies a search and replace pattern to apply to the response body.

The meaning of the pattern can be modified by using any combination of these flags:

i
Perform a case-insensitive match.
n
By default the pattern is treated as a regular expression. Using the n flag forces the pattern to be treated as a fixed string.
f
The f flag causes mod_substitute to flatten the result of a substitution allowing for later substitutions to take place on the boundary of this one. This is the default.
q
The q flag causes mod_substitute to not flatten the buckets after each substitution. This can result in a much faster response and a decrease in memory utilization, but should only be used if there is no possibility that the result of one substitution will ever match a pattern or regex of a subsequent one.

Example

<Location />

AddOutputFilterByType SUBSTITUTE text/html
Substitute s/foo/bar/ni

</Location>

If either the pattern or the substitution contains a slash character then an alternative delimiter should be used:

Example of using an alternate delimiter

<Location />

AddOutputFilterByType SUBSTITUTE text/html
Substitute "s|<BR */?>|<br />|i"

</Location>

ISBN 9781906966034The Apache HTTP Server Reference ManualSee the print edition