NAME
Mojo::Server::Daemon - Async IO HTTP 1.1 And WebSocket Server
SYNOPSIS
use Mojo::Server::Daemon;
my $daemon = Mojo::Server::Daemon->new(listen => ['http://*:8080']);
$daemon->on_request(sub {
my ($self, $tx) = @_;
# Request
my $method = $tx->req->method;
my $path = $tx->req->url->path;
# Response
$tx->res->code(200);
$tx->res->headers->content_type('text/plain');
$tx->res->body("$method request for $path!");
# Resume transaction
$tx->resume;
});
$daemon->run;
DESCRIPTION
Mojo::Server::Daemon is a full featured async io HTTP 1.1 and WebSocket server with IPv6
, TLS
, Bonjour
and libev
support.
Optional modules EV, IO::Socket::IP, IO::Socket::SSL and Net::Rendezvous::Publish are supported transparently and used if installed.
See Mojolicious::Guides::Cookbook for deployment recipes.
ATTRIBUTES
Mojo::Server::Daemon inherits all attributes from Mojo::Server and implements the following new ones.
backlog
my $backlog = $daemon->backlog;
$daemon = $daemon->backlog(128);
Listen backlog size, defaults to SOMAXCONN
.
group
my $group = $daemon->group;
$daemon = $daemon->group('users');
Group for server process.
ioloop
my $loop = $daemon->ioloop;
$daemon = $daemon->ioloop(Mojo::IOLoop->new);
Event loop for server IO, defaults to the global Mojo::IOLoop singleton.
keep_alive_timeout
my $keep_alive_timeout = $daemon->keep_alive_timeout;
$daemon = $daemon->keep_alive_timeout(15);
Maximum amount of time in seconds a connection can be inactive before being dropped, defaults to 5
.
listen
my $listen = $daemon->listen;
$daemon = $daemon->listen(['https://localhost:3000']);
List of one or more locations to listen on, defaults to http://*:3000
.
# Listen on two ports with HTTP and HTTPS at the same time
$daemon->listen(['http://*:3000', 'https://*:4000']);
# Use a custom certificate and key
$daemon->listen(['https://*:3000:/x/server.crt:/y/server.key']);
# Or even a custom certificate authority
$daemon->listen(['https://*:3000:/x/server.crt:/y/server.key:/z/ca.crt']);
max_clients
my $max_clients = $daemon->max_clients;
$daemon = $daemon->max_clients(1000);
Maximum number of parallel client connections, defaults to 1000
.
max_requests
my $max_requests = $daemon->max_requests;
$daemon = $daemon->max_requests(100);
Maximum number of keep alive requests per connection, defaults to 25
.
silent
my $silent = $daemon->silent;
$daemon = $daemon->silent(1);
Disable console messages.
user
my $user = $daemon->user;
$daemon = $daemon->user('web');
User for the server process.
websocket_timeout
my $websocket_timeout = $server->websocket_timeout;
$server = $server->websocket_timeout(300);
Maximum amount of time in seconds a WebSocket connection can be inactive before being dropped, defaults to 300
.
METHODS
Mojo::Server::Daemon inherits all methods from Mojo::Server and implements the following new ones.
prepare_ioloop
$daemon->prepare_ioloop;
Prepare event loop.
run
$daemon->run;
Start server.
setuidgid
$daemon->setuidgid;
Set user and group for process.
DEBUGGING
You can set the MOJO_DAEMON_DEBUG
environment variable to get some advanced diagnostics information printed to STDERR
.
MOJO_DAEMON_DEBUG=1