debian man page for plack::handler::apache2

Plack::Handler::Apache2(3pm)				User Contributed Perl Documentation			      Plack::Handler::Apache2(3pm)

NAME
       Plack::Handler::Apache2 - Apache 2.0 handlers to run PSGI application

SYNOPSIS
	 <Location />
	 SetHandler perl-script
	 PerlResponseHandler Plack::Handler::Apache2
	 PerlSetVar psgi_app /path/to/app.psgi
	 </Location>

	 # Optional, preload the application in the parent like startup.pl
	 <Perl>
	 use Plack::Handler::Apache2;
	 Plack::Handler::Apache2->preload("/path/to/app.psgi");
	 </Perl>

DESCRIPTION
       This is a handler module to run any PSGI application with mod_perl on Apache 2.x.

CREATING CUSTOM HANDLER
       If you want to create a custom handler that loads or creates PSGI applications using other means than loading from ".psgi" files, you can
       create your own handler class and use "call_app" class method to run your application.

	 package My::ModPerl::Handler;
	 use Plack::Handler::Apache2;

	 sub get_app {
	   # magic!
	 }

	 sub handler {
	   my $r = shift;
	   my $app = get_app();
	   Plack::Handler::Apache2->call_app($r, $app);
	 }

AUTHOR
       Tatsuhiko Miyagawa

CONTRIBUTORS
       Paul Driver

SEE ALSO
       Plack

perl v5.14.2							    2011-08-26					      Plack::Handler::Apache2(3pm)