NAME¶
Mojo::Server::Daemon - Non-blocking I/O HTTP 1.1 and WebSocket server
SYNOPSIS¶
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;
DESCRIPTION¶
Mojo::Server::Daemon is a full featured non-blocking I/O HTTP 1.1 and WebSocket
server with "IPv6", "TLS" and "libev" support.
Optional modules EV, IO::Socket::INET6 and IO::Socket::SSL are supported
transparently and used if installed. Individual features can also be disabled
with the "MOJO_NO_IPV6" and "MOJO_NO_TLS" environment
variables.
See Mojolicious::Guides::Cookbook for more.
EVENTS¶
Mojo::Server::Daemon inherits all events from Mojo::Server.
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.
"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
closed, defaults to the value of the "MOJO_INACTIVITY_TIMEOUT"
environment variable or 15. Setting the value to 0 will allow connections to
be inactive indefinitely.
"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 the value of the
"MOJO_LISTEN" environment variable or "
http://*:3000".
# Listen on IPv6 interface
$daemon->listen(['http://[::1]:4000']);
# Listen on two ports with HTTP and HTTPS at the same time
$daemon->listen([qw(http://*:3000 https://*:4000)]);
# Use a custom certificate and key
$daemon->listen(['https://*:3000?cert=/x/server.crt&key=/y/server.key']);
# Or even a custom certificate authority
$daemon->listen(
['https://*:3000?cert=/x/server.crt&key=/y/server.key&ca=/z/ca.crt']);
These parameters are currently available:
- "ca"
- Path to TLS certificate authority file.
- "cert"
- Path to the TLS cert file, defaults to a built-in test
certificate.
- "key"
- Path to the TLS key file, defaults to a built-in test
key.
"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.
METHODS¶
Mojo::Server::Daemon inherits all methods from Mojo::Server and implements the
following new ones.
"run"¶
$daemon->run;
Run server.
"setuidgid"¶
$daemon = $daemon->setuidgid;
Set user and group for process.
"start"¶
$daemon->start;
Start accepting connections.
DEBUGGING¶
You can set the "MOJO_DAEMON_DEBUG" environment variable to get some
advanced diagnostics information printed to "STDERR".
MOJO_DAEMON_DEBUG=1
SEE ALSO¶
Mojolicious, Mojolicious::Guides, <
http://mojolicio.us>.