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>