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

For much more power, see the HTML::Embperl and Apache::ePerl modules.

mod_include, mod_perl(3), HTML::TreeBuilder(3), Apache(3), HTML::Embperl(3), Apache::ePerl(3)

AUTHOR

Doug MacEachern <dougm@osf.org>