NAME

Apache::SSI - Implement Server Side Includes in Perl

SYNOPSIS

wherever you choose:

<Files *.phtml> SetHandler perl-script PerlHandler Apache::SSI </Files>

You may wish to subclass Apache::SSI for your own extentions 

    package MySSI;
    use Apache::SSI ();
    @ISA = qw(Apache::SSI);


    #embedded syntax:
    #<!--#something cmd=doit -->
    sub something {
       my($self, $attr) = @_;
       my $cmd = $attr->{cmd};
       ...
       return $a_string;	   
    }

DESCRIPTION

Apache::SSI implements the functionality of mod_include for handling server-parsed html documents. Each ``command'' or element is handled by an Apache::SSI method of the same name. attribute=value pairs are parsed and passed to the method in an anonymous hash.

This module supports the same directives as mod_include, see it's documentation for commands and syntax.

In addition, Apache::SSI supports the following directives:

perlsub
This directive calls a perl subroutine: 

 Hello user from <!--#perlsub sub=remote_host -->

CAVEATS

This module is not complete, it does not provide the full functionality of mod_include.

There is no support for xssi directives.

SEE ALSO

mod_include, mod_perl, HTML::TreeBuilder(3), perl, Apache

AUTHOR

Doug MacEachern