Server Fault is a question and answer site for system and network administrators. It's 100% free, no registration required.

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I've got an Apache web server that delivers static HTML pages. For some reason I can't change the files themselves, but I still want to inject some HTML into every page that is being served.

Is this possible with mod_proxy? If not, could anyone recommend a software that provides such a feature?

EDIT: I have to insert some kind of banner ad (e.g. a javascript) and a tracking pixel.

share|improve this question
up vote 14 down vote accepted

You could do this: Work with mod_rewrite to change requests from




then use PHP (or whatever you find appropriate) to do the file-manipulation. Add an output cache to improve performance.

As an alternative, Apache Handlers sound helpful:

Modifying static content using a CGI script

The following directives will cause requests for files with the html extension to trigger the launch of the CGI script.

Action add-footer /cgi-bin/
AddHandler add-footer .html

Then the CGI script is responsible for sending the originally requested document (pointed to by the PATH_TRANSLATED environment variable) and making whatever modifications or additions are desired.

This is more or less what the mod_rewrite approach would do, only with less hackery.

share|improve this answer

I am not sure why this hasn't been mentioned in the list of answer. Sorry if it took me 2 years to see this question...

The easiest, most powerful way to do what you want to do what you want is using an Apache filter.

Just have:

ExtFilterDefine css_changer mode=output intype=text/html cmd="/some/php/script.php"
SetOutputFilter css_changer

A possible script:


#phpinfo(); // Uncomment to see ALL env variables
$host = $_ENV["HTTP_HOST"]; //
$script_name = $_ENV["SCRIPT_NAME"]; // /theme/green/style.css
$pi = pathinfo($script_name);
$type = $pi['extension'];
#print "$host $script  $type";

$stdin = fopen('php://stdin', 'r');

while($line = fgets($stdin)){
  $line = preg_replace('/a/','A',$line);

  fwrite($stdout, $line);

This will change all "a"s into "A"s .

Be sure to enable filter in your httpd.conf, like this:

LoadModule ext_filter_module libexec/apache2/

This question ranks really up in Google and there isn't much out there in terms of forums

share|improve this answer
That's by far the best solution, i was able to find for a similar problem. Thanks very much for sharing! – harald Dec 18 '12 at 11:48

Here is a tutorial on how to use mod_proxy_html to edit the links on a webpage ( the content). You might be able to apply this modify the html you want.

UPDATE: Are you sure you want to go this route? I think Apache is meant to serve content, not create it. This would probably go in the view part of a MVC framework. The reason I wouldn't recommend this is you are breaking the rule of modularity. Your web application will be intertwined with the application that server it, complicating future upgrades, moves, etc.

share|improve this answer
Hm, if I get it right mod_proxy_html is not capable to add complete new code snipets? – Node Jul 27 '09 at 12:38
Not sure, now that you have added more, Commander Tomalak's answer sounds better. You are in the land of hackery I would say, creating web pages isn't really what Apache is for, it is for serving up content. – Kyle Brandt Jul 27 '09 at 12:54
I tought that there is maybe some kind of standalone proxy which could rewrite html pages. Something like MySQL Proxy for MySQL. Maybe Privoxy could do this. – Node Jul 27 '09 at 13:03
@Kyle Brandt: LOL - I think the mention of the military rank officially makes you a trekkie. This made my day. :) – Tomalak Jul 27 '09 at 13:15

mod_sed is a good fit here. You can create an output filter that matches the closing head or body tag, for example, and insert your html before it.

share|improve this answer

I would prefer to do this with mod_rewrite and SSI.

First put the path into an environment variable

RewriteCond %{IS_SUBREQ} false
RewriteRule ^(/.*\.html) /page.shtml [E:filename:$1]

then process that in the shtml file

<!--#include virtual="$filename"-->

(parts of this solution are based on a stackoverflow question )

share|improve this answer
My main reason to want to use shtml for this would be that calling an external CGI for each request might cause load problems. – Alex Lehmann Jul 28 '09 at 12:26

Would a mod_perl module be any use?

That might do what you want or, at least, point you in the right direction.

share|improve this answer
Thx, I'll have a look, at the moment we tend to with a custom – Node Jul 27 '09 at 13:55

You could use Apache mod_substitute to inject html into outgoing responses using some criteria or regular expressions. Here is an explanation of how to achieve this.

share|improve this answer

you can look into the header and footer directive of apache, Using the directives below.

<Directory "/usr/local/www/data/scott">
    Options +Indexes
    AllowOverride All
    AddOutputFilter LAYOUT html htm shtml
    LayoutComment On
    LayoutHeader /wrappers/scott-header.html
    LayoutFooter /wrappers/scott-footer.html

More reading is here:

share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.