Apache::PerlRunUser Contributed Perl DocumentatApache::PerlRun(3)NAMEApache::PerlRun - Run unaltered CGI scripts under mod_perl
SYNOPSIS
#in httpd.conf
Alias /cgi-perl/ /perl/apache/scripts/
PerlModule Apache::PerlRun
<Location /cgi-perl>
SetHandler perl-script
PerlHandler Apache::PerlRun
Options +ExecCGI
#optional
PerlSendHeader On
...
</Location>
DESCRIPTION
This module's handler emulates the CGI environment, allow
ing programmers to write scripts that run under CGI or
mod_perl without change. Unlike Apache::Registry, the
Apache::PerlRun handler does not cache the script inside
of a subroutine. Scripts will be "compiled" every
request. After the script has run, it's namespace is
flushed of all variables and subroutines.
The Apache::Registry handler is much faster than
Apache::PerlRun. However, Apache::PerlRun is much faster
than CGI as the fork is still avoided and scripts can use
modules which have been pre-loaded at server startup time.
This module is meant for "Dirty" CGI Perl scripts which
relied on the single request lifetime of CGI and cannot
run under Apache::Registry without cleanup.
CAVEATS
If your scripts still have problems running under the
Apache::PerlRun handler, the PerlRunOnce option can be
used so that the process running the script will be shut
down. Add this to your httpd.conf:
<Location ...>
PerlSetVar PerlRunOnce On
...
</Location>
SEE ALSOperl(1), mod_perl(3), Apache::Registry(3)AUTHOR
Doug MacEachern
2002-05-29 mod_perl-1.27 Apache::PerlRun(3)