Mason is suitable for use in a CGI environment.
HTML::Mason::CGIHandler is a Perl module specifically designed to use Mason in a CGI environment. This module allows the execution of Mason components in a CGI environment without worrying about the specifics of invoking it on each request. By keeping the top-level components in the web server's document root and using regular component syntax, the user can easily use this tool for executing Mason components.
To use HTML::Mason::CGIHandler, you must add the module to your httpd.conf or .htaccess file using the LocationMatch directive, along with the Action and AddHandler attributes. Additionally, you must add a script to /cgi-bin/mason_handler.pl, which contains the location of the data directory and a list of allowed globals. The handle_request function is then used to execute the script.
HTML::Mason::CGIHandler also provides an $r request object, which allows users to access the CGI query for missing functionality. Though this object has limited functionality, HTML::Mason::CGIHandler aims to replicate mod_perl functionality as closely as possible. If any differences are found, they may be fixed in future releases.
Lastly, this module alters the HTML::Mason::Request object $m to provide direct access to the CGI query if necessary. If you need some missing functionality in $r, let HTML::Mason::CGIHandler know, as it may be able to provide it. Overall, HTML::Mason::CGIHandler is a useful tool for executing Mason components in a CGI environment.
To use HTML::Mason::CGIHandler, you must add the module to your httpd.conf or .htaccess file using the LocationMatch directive, along with the Action and AddHandler attributes. Additionally, you must add a script to /cgi-bin/mason_handler.pl, which contains the location of the data directory and a list of allowed globals. The handle_request function is then used to execute the script.
HTML::Mason::CGIHandler also provides an $r request object, which allows users to access the CGI query for missing functionality. Though this object has limited functionality, HTML::Mason::CGIHandler aims to replicate mod_perl functionality as closely as possible. If any differences are found, they may be fixed in future releases.
Lastly, this module alters the HTML::Mason::Request object $m to provide direct access to the CGI query if necessary. If you need some missing functionality in $r, let HTML::Mason::CGIHandler know, as it may be able to provide it. Overall, HTML::Mason::CGIHandler is a useful tool for executing Mason components in a CGI environment.
What's New
Version 1.40: N/A