Mojo::Server::Daemon - Non-blocking I/O HTTP 1.1 and WebSocket server
use Mojo::Server::Daemon; my $daemon = Mojo::Server::Daemon->new(listen => ['http://*:8080']); $daemon->unsubscribe('request'); $daemon->on(request => sub { my ($daemon, $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;
Mojo::Server::Daemon is a full featured non-blocking I/O HTTP 1.1 and WebSocket server with IPv6, TLS, Bonjour and libev support.
IPv6
TLS
Bonjour
libev
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.
Mojo::Server::Daemon inherits all events from Mojo::Server.
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.
SOMAXCONN
group
my $group = $daemon->group; $daemon = $daemon->group('users');
Group for server process.
inactivity_timeout
my $timeout = $daemon->inactivity_timeout; $daemon = $daemon->inactivity_timeout(5);
Maximum amount of time in seconds a connection can be inactive before getting dropped, defaults to 15. Setting the value to 0 will allow connections to be inactive indefinitely.
15
0
ioloop
my $loop = $daemon->ioloop; $daemon = $daemon->ioloop(Mojo::IOLoop->new);
Loop object to use for I/O operations, defaults to the global Mojo::IOLoop singleton.
listen
my $listen = $daemon->listen; $daemon = $daemon->listen(['https://localhost:3000']);
List of one or more locations to listen on, defaults to http://*:3000.
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.
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.
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 $timeout = $server->websocket_timeout; $server = $server->websocket_timeout(300);
Maximum amount of time in seconds a WebSocket connection can be inactive before getting dropped, defaults to 300. Setting the value to 0 will allow WebSocket connections to be inactive indefinitely.
300
Mojo::Server::Daemon inherits all methods from Mojo::Server and implements the following new ones.
run
$daemon->run;
Run server.
setuidgid
$daemon->setuidgid;
Set user and group for process.
start
$daemon->start;
Start accepting connections.
You can set the MOJO_DAEMON_DEBUG environment variable to get some advanced diagnostics information printed to STDERR.
MOJO_DAEMON_DEBUG
STDERR
MOJO_DAEMON_DEBUG=1
Mojolicious, Mojolicious::Guides, http://mojolicio.us.
To install Mojolicious, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mojolicious
CPAN shell
perl -MCPAN -e shell install Mojolicious
For more information on module installation, please visit the detailed CPAN module installation guide.