The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Mojo::Server::Daemon - Async IO HTTP 1.1 And WebSocket Server

SYNOPSIS

    use Mojo::Server::Daemon;

    my $daemon = Mojo::Server::Daemon->new;
    $daemon->listen('http://*:8080');
    $daemon->run;

DESCRIPTION

Mojo::Server::Daemon is a full featured async io HTTP 1.1 and WebSocket server with IPv6, TLS, epoll, kqueue, hot deployment and UNIX domain socket sharing support.

Optional modules IO::KQueue, IO::Epoll, IO::Socket::INET6 and IO::Socket::SSL are supported transparently and used if installed.

ATTRIBUTES

Mojo::Server::Daemon inherits all attributes from Mojo::Server and implements the following new ones.

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);

Timeout for keep alive connections in seconds, defaults to 15.

listen

    my $listen = $daemon->listen;
    $daemon    = $daemon->listen('https://localhost:3000,file:/my.sock');

Ports and files to listen on, defaults to http://*:3000.

listen_queue_size

    my $listen_queue_size = $daemon->listen_queue_zise;
    $daemon               = $daemon->listen_queue_zise(128);

Listen queue size, defaults to SOMAXCONN.

lock_file

    my $lock_file = $daemon->lock_file;
    $daemon       = $daemon->lock_file('/tmp/mojo_daemon.lock');

Path to lock file, defaults to a random temporary file.

max_clients

    my $max_clients = $daemon->max_clients;
    $daemon         = $daemon->max_clients(1000);

Maximum number of parallel client connections, defaults to 1000.

max_keep_alive_requests

    my $max_keep_alive_requests = $daemon->max_keep_alive_requests;
    $daemon                     = $daemon->max_keep_alive_requests(100);

Maximum number of keep alive requests per connection, defaults to 100.

pid_file

    my $pid_file = $daemon->pid_file;
    $daemon      = $daemon->pid_file('/tmp/mojo_daemon.pid');

Path to process id file, defaults to a random temporary file.

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);

Timeout in seconds for WebSockets to be idle, defaults to 300.

METHODS

Mojo::Server::Daemon inherits all methods from Mojo::Server and implements the following new ones.

accept_lock

    my $lock = $daemon->accept_lock($blocking);

Try to get the accept lock.

accept_unlock

    $daemon->accept_unlock;

Free the accept lock.

prepare_ioloop

    $daemon->prepare_ioloop;

Prepare event loop.

prepare_lock_file

    $daemon->prepare_lock_file;

Prepare the lock file.

prepare_pid_file

    $daemon->prepare_pid_file;

Prepare process id file.

run

    $daemon->run;

Start server.

setuidgid

    $daemon->setuidgid;

Set user and group for process.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicious.org.