Apache::PerlRun(3) User Contributed Perl Documentation Apache::PerlRun(3)

NAME
       Apache::PerlRun - Run unaltered CGI scripts under modperl

SYNOPSIS
        #in httpd.conf

        Alias /cgi-perl/ /perl/apache/scripts/
        PerlModule Apache::PerlRun

        
        SetHandler perl-script
        PerlHandler Apache::PerlRun
        Options +ExecCGI
        #optional
        PerlSendHeader On
        ...
        

DESCRIPTION
       This module's hhaannddlleerr emulates the CGI environment, allowing program-
       mers to write scripts that run under CGI or modperl without change.
       Unlike AAppaacchhee::::RReeggiissttrryy, the AAppaacchhee::::PPeerrllRRuunn 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 AAppaacchhee::::RReeggiissttrryy handler is much faster than AAppaacchhee::::PPeerrllRRuunn.  How-
       ever, AAppaacchhee::::PPeerrllRRuunn 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
       AAppaacchhee::::RReeggiissttrryy without cleanup.

CCAAVVEEAATTSS
       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 shutdown.  Add this to your httpd.conf:

        
        PerlSetVar PerlRunOnce On
        ...
        

SEE ALSO
       perl(1), modperl(3), Apache::Registry(3)

AUTHOR       Doug MacEachern



perl v5.8.6                       2000-03-30                Apache::PerlRun(3)