Apache::PerlRun(3pm) - phpMan

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



NAME
       Apache::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, allowing programmers to write scripts
       that run under CGI or mod_perl without change.  Unlike Apache::Registry, the Apache::Perl-
       Run 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::Perl-
       Run 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 Perl-
       RunOnce option can be used so that the process running the script will be shutdown.  Add
       this to your httpd.conf:

        <Location ...>
        PerlSetVar PerlRunOnce On
        ...
        </Location>

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

AUTHOR
       Doug MacEachern



perl v5.8.4                                 1999-01-17                       Apache::PerlRun(3pm)

Generated by $Id: phpMan.php,v 4.49 2006/02/26 13:18:18 chedong Exp $ Author: Che Dong
On Apache/2.0.61 (Unix) PHP/4.4.7 mod_ssl/2.0.61 OpenSSL/0.9.7e mod_fastcgi/2.4.2 DAV/2 SVN/1.4.2
Under GNU General Public License
2009-01-06 17:05 @38.103.63.57 Crawled by CCBot/1.0 (+http://www.commoncrawl.org/bot.html)