/ 
Apache-Sandwich-1.10
/ Apache::Sandwich

NAME

Apache::Sandwich - Layered document (sandwich) maker

SYNOPSIS

SetHandler  perl-script
PerlHandler Apache::Sandwich

DESCRIPTION

The Apache::Sandwich module allows you to add a per-directory custom "header" and/or "footer" content to a given uri.

Here's a configuration example:

#in httpd.conf or .htaccess

<Location /foo>
 #any request for /foo and it's document tree
 #are run through our Apache::Sandwich::handler
 SetHandler  perl-script
 PerlHandler Apache::Sandwich

 #we send this file first
 PerlSetVar HEADER /my_header.html

 #requested uri (e.g. /foo/index.html) is sent in the middle

 #we send output of this mod_perl script last  
 PerlSetVar FOOTER /perl/footer.pl

</Location>

KNOWN BUGS

Headers printed by mod_perl scripts used as a HEADER, FOOTER or in-the-middle uri need to use CGI.pm version 2.37 or higher or headers will show up in the final document (browser window). Suggested work-around (if you don't want to upgrade CGI.pm):

    if($ENV{MOD_PERL} and Apache->request->is_main) {
        #send script headers
	print "Content-type: text/html\n\n";
    }
    else {
       #we're part of a sub-request, don't send headers
    }

AUTHOR

Doug MacEachern