Introduction

mod_replace is an Apache 2.0.x filter module that allows you to replace text strings based on regular expressions. Most commonly it is used together with mod_proxy to sanitize the behaviour of ill behaving web applications / servers when using Apache as an reverse proxy. Other uses are, of course, supported as well.

It has been tested on Solaris 8/Sparc and Linux/i386 with various versions of Apache 2.0.x (development started with 2.0.44, tested with all releases up to 2.0.49). Although it has only been tested on those two platforms, this doesn´t mean it won´t work for others. Any reports of successfull or unsuccessfull deployment is more than welcome!

Getting started

To get started, first grab the sources and follow the installation guidelines in the included INSTALL file.

Download Page

The documentation and FAQ for this module are located here: Documentation and Frequently asked questions

TODO

• Modification of HTTP request bodies
• Code cleanup
• Performance improvements
• Tests on other platforms
• More documentation and examples
• Someone to audit this code for performance bottlenecks and security problems!?
• Subpattern support for ALL replacement methods
• Support for standalone compilation (aka writing a Makefile)
• Maybe supplying binary packages

Links

• http://www.science-computing.de - Sponsored most of the development work of the initial release of mod_replace.
• http://httpd.apache.org - The Apache Webserver Project.
• http://lxr.webperf.org - An online version of Apache´s source code. Very helpful!
• http://www.pcre.org - The Perl Compatible Regular Expression library.

is kindly hosting this project.