HTML::Mason::ApacheHandler2 0.01

HTML::Mason::ApacheHandler2 is highly experimental module and should only be used in a test environment.

HTML::Mason::ApacheHandler2 was written to allow Mason to run in a 'pure' mod_perl2/Apache2 environment using the mod_perl2 native request structure as implemented by libapreq2. As such, this module is highly experimental and definitely not-ready-for-prime-time. This is an unofficial release, not supported by the Mason group. If you want to use this module in a testing environment, please address problems, issues, comments, and improvements to me, not Mason.

When deciding to port Mason to mod_perl2 I took the approach to add Module(s) rather than patching core Mason modules. Upon investigation I discovered that all the Apache 'glue' code in Mason was contained in HTML::Mason::ApacheHandler. Therefore, I renamed and modified that module to create HTML::Mason::ApacheHandler2.

The actual changes I made can be found in the distribution in diff/ApacheHandler.diff ( made with 'diff -Naru' ... ).

As a result of my approach, you may install the normal Mason ( >= 1.25 ), the modules in "PREREQUISITES" below, and this module. After configuring ( see "CONFIGURATION" below ), you're ready to play.

The ApacheHandler2 object links Mason to mod_perl2, running components in response to HTTP requests. It is controlled primarily through parameters to the new() constructor.

handle_request() is not a user method, but rather is called from the HTML::Mason::handler() routine in handler.pl.

HTML::Mason::ApacheHandler2 is a modified copy of the standard HTML::Mason::ApacheHandler. ApacheHandler2 MUST be used with mod_perl2.

You may, however, run Mason with Apache2/mod_perl2 without ApacheHandler2 (see my rather dated mini-HOWTO at http://beaucox.com/mason/mason-with-apmp2-mini-HOWTO.htm), but you then use use 'CGI' requests rather than the native 'mod_perl' requests.

The interface is the same as ApacheHandler's, Please refer to HTML::Mason, HTML::Mason::ApacheHandler, and http://masonhq.com/docs/manual/Admin.html.

SYNOPSIS

 use HTML::Mason::ApacheHandler2;
 
 my $ah = HTML::Mason::ApacheHandler2->new (..name/value params..);
 ...
 sub handler {
 my $r = shift;
 $ah->handle_request($r);
 }


Product's homepage

Requirements:

· Perl