Summary: This is an experimental interface for Mason/mod_perl2, still in beta stage.
MasonX::Apache2Handler is a software tool that provides a simple clone of Mason's HTML::Mason::ApacheHandler. With the use of the mod_perl 2 and libapreq2 components, this tool seems to be solid. However, it is important to note that these components are still under development and each gives a version of the above warning. If you are interested in transitioning to mod_perl 2 when it reaches production status, it is highly encouraged to test these modules in a safe environment as your feedback will help in getting mod_perl 2 ready for release.
As an unofficial release that is not supported by the Mason group, MasonX::Apache2Handler was designed to allow Mason to operate in a 'pure' mod_perl2/Apache2 environment using the mod_perl2 native request structure as implemented by libapreq2. If you encounter any problems, issues, comments, and improvements while using this module in a testing environment, please address them to the creator rather than Mason.
To make Mason compatible with mod_perl2, the creator of MasonX::Apache2Handler added a module rather than patching core Mason modules. The Apache 'glue' code in Mason was found in HTML::Mason::ApacheHandler, which was then renamed and modified to create MasonX::Apache2Handler. The changes made can be found within the distribution in diff/ApacheHandler.diff (made with 'diff -Naru'...).
After installing the required modules listed in "PREREQUISITES" and configuring (see "CONFIGURATION" below), you can start using MasonX::Apache2Handler right away. The Apache2Handler object links Mason to mod_perl2, allowing components to run in response to HTTP requests. The object is primarily controlled through parameters to the new() constructor, and handle_request() is called from the HTML::Mason::handler() routine in handler.pl.
It is important to note that Apache2Handler MUST be used with mod_perl2, otherwise you can use 'CGI' requests instead of the native 'mod_perl' requests. The interface is the same as ApacheHandler's, so it is highly recommended to refer to HTML::Mason, HTML::Mason::ApacheHandler, and SYNOPSIS for further information.
In conclusion, if you are looking for a reliable tool to clone Mason's HTML::Mason::ApacheHandler, then MasonX::Apache2Handler is a great option to consider. It provides a simple solution to run components using mod_perl2 and libapreq2 in a 'pure' mod_perl2/Apache2 environment.
As an unofficial release that is not supported by the Mason group, MasonX::Apache2Handler was designed to allow Mason to operate in a 'pure' mod_perl2/Apache2 environment using the mod_perl2 native request structure as implemented by libapreq2. If you encounter any problems, issues, comments, and improvements while using this module in a testing environment, please address them to the creator rather than Mason.
To make Mason compatible with mod_perl2, the creator of MasonX::Apache2Handler added a module rather than patching core Mason modules. The Apache 'glue' code in Mason was found in HTML::Mason::ApacheHandler, which was then renamed and modified to create MasonX::Apache2Handler. The changes made can be found within the distribution in diff/ApacheHandler.diff (made with 'diff -Naru'...).
After installing the required modules listed in "PREREQUISITES" and configuring (see "CONFIGURATION" below), you can start using MasonX::Apache2Handler right away. The Apache2Handler object links Mason to mod_perl2, allowing components to run in response to HTTP requests. The object is primarily controlled through parameters to the new() constructor, and handle_request() is called from the HTML::Mason::handler() routine in handler.pl.
It is important to note that Apache2Handler MUST be used with mod_perl2, otherwise you can use 'CGI' requests instead of the native 'mod_perl' requests. The interface is the same as ApacheHandler's, so it is highly recommended to refer to HTML::Mason, HTML::Mason::ApacheHandler, and SYNOPSIS for further information.
In conclusion, if you are looking for a reliable tool to clone Mason's HTML::Mason::ApacheHandler, then MasonX::Apache2Handler is a great option to consider. It provides a simple solution to run components using mod_perl2 and libapreq2 in a 'pure' mod_perl2/Apache2 environment.
What's New
Version 0.05: N/A