libapache2-mod-perl2-2.0.7::docs::api::ModPerl::PerlRun(User Contributed Perl Documentlibapache2-mod-perl2-2.0.7::docs::api::ModPerl::PerlRun(3pm)

NAME

       ModPerl::PerlRun - Run unaltered CGI scripts under mod_perl

Synopsis
	 # httpd.conf
	 PerlModule ModPerl::PerlRun
	 Alias /perl-run/ /home/httpd/perl/
	 <Location /perl-run>
	     SetHandler perl-script
	     PerlResponseHandler ModPerl::PerlRun
	     PerlOptions +ParseHeaders
	     Options +ExecCGI
	 </Location>

Description
       META: document that for now we don't chdir() into the script's dir, because it affects the whole process under threads.
       "ModPerl::PerlRunPrefork" should be used by those who run only under prefork MPM.

Special Blocks
   "BEGIN" Blocks
       When running under the "ModPerl::PerlRun" handler "BEGIN" blocks behave as follows:

       o   "BEGIN" blocks defined in scripts running under the "ModPerl::PerlRun" handler are executed on each and every request.

       o   "BEGIN" blocks defined in modules loaded from scripts running under "ModPerl::PerlRun" (and which weren't already loaded prior to the
	   request) are executed on each and every request only if those modules declare no package. If a package is declared "BEGIN" blocks will
	   be run only the first time each module is loaded, since those modules don't get reloaded on subsequent requests.

       See also "BEGIN" blocks in mod_perl handlers.

   "CHECK" and "INIT" Blocks
       Same as normal mod_perl handlers.

   "END" Blocks
       Same as "ModPerl::Registry".

Authors
       Doug MacEachern

       Stas Bekman

See Also
       "ModPerl::RegistryCooker" and "ModPerl::Registry".

perl v5.14.2							    2011-02-08	      libapache2-mod-perl2-2.0.7::docs::api::ModPerl::PerlRun(3pm)