Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Plack::Handler(3)     User Contributed Perl Documentation    Plack::Handler(3)

NAME
       Plack::Handler -	Connects PSGI applications and Web servers

SYNOPSIS
	 package Plack::Handler::AwesomeWebServer;
	 sub new {
	     my($class,	%opt) =	@_;
	     ...
	     return $self;
	 }

	 sub run {
	     my($self, $app) = @_;
	     # launch the AwesomeWebServer and run $app	in the loop
	 }

	 # then	from command line
	 plackup -s AwesomeWebServer -a	app.psgi

DESCRIPTION
       Plack::Handler defines an adapter (connector) interface to adapt
       plackup and Plack::Runner to various PSGI web servers, such as Apache2
       for mod_perl and	Standalone for HTTP::Server::PSGI.

       It is an	empty class, and as long as they implement the methods defined
       as an Server adapter interface, they do not need	to inherit
       Plack::Handler.

       If you write a new handler for existing web servers, I recommend	you to
       include the full	name of	the server module after	Plack::Handler prefix,
       like Plack::Handler::Net::Server::Coro if you write a handler for
       Net::Server::Coro. That way you'll be using plackup command line	option
       like:

	 plackup -s Net::Server::Coro

       that makes it easy to figure out	which web server you're	going to use.

METHODS
       new
	     $server = FooBarServer->new(%args);

	   Creates a new adapter object. %args can take	arbitrary parameters
	   to configure	server environments but	common parameters are:

	   port	   Port	number the server listens to.

	   host	   Address the server listens to. Set to undef to listen any
		   interface.

       run
	     $server->run($app);

	   Starts the server process and when a	request	comes in, run the PSGI
	   application passed in $app in the loop.

       register_service
	     $server->register_service($app);

	   Optional interface if your server should run	in parallel with other
	   event loop, particularly AnyEvent. This is the same as "run"	but
	   doesn't run the main	loop.

SEE ALSO
       rackup

perl v5.32.0			  2018-02-10		     Plack::Handler(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Plack::Handler&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help