The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Apache::Registry - Run (mostly) unaltered CGI scripts through mod_perl

SYNOPSIS

 #in srm.conf

 PerlAlias /perl/ /perl/apache/scripts/ #optional
 PerlModule Apache::Registry 
 
 AddHandler perl-script .fpl
 
 #in access.conf
 <Directory /perl/apache/scripts>
 PerlHandler Apache::Regsistry::handler
 ...
 </Directory>

DESCRIPTION

URIs in the form of: http://www.host.com/perl/file.pl

Will be compiled as the body of a perl subroutine and executed. Each server process or 'child' will compile the subroutine once and store it in memory until the file is updated on the disk.

The file looks much like a "normal" script, but it is compiled or 'evaled' into a subroutine.

Here's an example:

 my $r = Apache->request;
 $r->content_type("text/html");
 $r->send_http_header;
 $r->print("Hi There!");

Apache::Registry::handler will preform the same checks as mod_cgi before running the script.

DEBUGGING

You may set the debug level with the $Apache::Registry::Debug bitmask

 1 => log recompile in errorlog
 2 => Apache::Debug::dump in case of $@
 4 => trace pedantically
 

SEE ALSO

perl(1), Apache(3), Apache::Debug(3)

AUTHORS

Andreas Koenig <andreas.koenig@franz.ww.tu-berlin.de> and Doug MacEachern <dougm@osf.org>