[ANNOUNCE] Apache::IncludeHook

[Geoffrey Young <ge...@modperlcookbook.org>]

hi all...

I wanted to let everyone know that I have ported <!-- #perl --> SSI tag 
support to Apache 2.0.  it should behave under both prefork and threaded 
mpms, and work pretty much the same as it did in Apache 1.3, despite the 
fact that mod_include is now an output filter.

while the support is fairly complete, the code is a bit messy and can be 
refactored.  however, I wanted to get something released for people to play 
with before I needed to move on to something else.

--Geoff


The URL
 
http://www.modperlcookbook.org/~geoff/modules/Apache-IncludeHook-2.00_01.tar.gz

has entered CPAN as

   file: $CPAN/authors/id/G/GE/GEOFF/Apache-IncludeHook-2.00_01.tar.gz
   size: 7289 bytes
    md5: 0753eda141bf886290fa872fbffaf580


from the README:

NAME

Apache::IncludeHook - #perl Server Side Include support

SYNOPSIS

   PerlModule Apache::IncludeHook

   Alias /ssi /usr/local/apache/htdocs
   <Location /ssi>
     AddType text/html .shtml
     AddOutputFilter INCLUDES .shtml
     Options +Includes
   </Location>

DESCRIPTION

Apache::IncludeHook offers support for #perl tags in
documents parsed by the mod_include engine included in
the Apache 2.0 distribution.  Supported formats include

   <!--#perl sub="My::PrintArgs" -->
   <!--#perl arg="fee" sub="My::PrintArgs" arg="fie" -->
   <!--#perl arg="foe" sub="My::PrintArgs::handler" -->
   <!--#perl arg="fum" sub="My::PrintArgs->method_handler" --> here
   <!--#perl arg="I smell" sub="sub { my $r = shift; print @_ }" -->

In Apache 1.3, mod_include supported #perl tags out of
the box.  In 2.0, support for tags outside the standard
mod_include realm ('echo', 'flastmod', etc) have been removed,
having been replaced with an API that allows you to hook
your own functionality into mod_include's parsing engine.
The 'exec' tag is an example of one that is no longer natively
supported by mod_include - mod_cgi now supplies the base
implementaiton of this tag.

The current hope with this module is simply to carry over #perl tag
support from Apache 1.3 to 2.0.  Apache::SSI-like support
for custom tags will (possibly come later).  keep in mind
that while this module is not inteneded to replace the old
Apache::SSI for Apache 1.3, because the new Apache 2.0 API
includes a filtering mechansim,
you already have the ability to post-process SSI tags via
Perl (or C) output filters.

EXAMPLE

   file.shtml:

     perl <!--#perl arg="one" sub="My::PrintArgs" --> here

   PrintArgs.pm:

     package My::PrintArgs;

     use Apache::RequestRec ();
     use Apache::Const -compile => 'OK';

     use strict;

     sub handler {
 

       my ($r, @args) = @_;
 

       print join ' ', '***', (join ' : ', @args), '***';

       return Apache::OK;
     }

which is almost identical to what you would see with mod_perl 1.0,
save the mod_perl 2.0 specific classes.

NOTES

This implementation is designed to hook into the mod_include
that ships with Apache 2.0.  It will not work with Apache 2.1.

This is alpha ware, subject to massive API changes.  Meaning,
the TIEHANDLE interface may go away and you may be forced to
use only the (currently non-existent) filter interface.  so
get to know filters now before it's too late (they're really
cool anyway).

FEATURES/BUGS

Subrequests are still a work in progress - they still don't seem
to work properly from filters.

only print STDOUT and $r->print are supported.  other methods
of sending content to the client still need to be implemented.

AUTHOR

Geoffrey Young E<lt>geoff@modperlcookbook.orgE<gt>

COPYRIGHT

Copyright (c) 2003, Geoffrey Young

All rights reserved.

This module is free software.  It may be used, redistributed
and/or modified under the same terms as Perl itself.

Re: [ANNOUNCE] Apache::IncludeHook

[Stas Bekman <st...@stason.org>]

Geoffrey Young wrote:
> hi all...
> 
> I wanted to let everyone know that I have ported <!-- #perl --> SSI tag 
> support to Apache 2.0.  it should behave under both prefork and threaded 
> mpms, and work pretty much the same as it did in Apache 1.3, despite the 
> fact that mod_include is now an output filter.
> 
> while the support is fairly complete, the code is a bit messy and can be 
> refactored.  however, I wanted to get something released for people to 
> play with before I needed to move on to something else.

geoff++

can you please update this page?
http://perl.apache.org/products/apache-modules.html#Porting_CPAN_modules_to_mod_perl_2_0_Status
thanks.

__________________________________________________________________
Stas Bekman            JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/     mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org   http://ticketmaster.com