Last Change: 2018-09-07, 16:50
powered by manpag.es
Plack::Handler - Connects PSGI applications and Web servers
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
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.
|
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.
rackup