NAME

       Mojo::Server - HTTP/WebSocket server base class

SYNOPSIS

         package Mojo::Server::MyServer;
         use Mojo::Base 'Mojo::Server';

         sub run {
           my $self = shift;

           # Get a transaction
           my $tx = $self->build_tx;

           # Emit "request" event
           $self->emit(request => $tx);
         }

DESCRIPTION

       Mojo::Server is an abstract base class for HTTP/WebSocket servers and server interfaces,
       like Mojo::Server::CGI, Mojo::Server::Daemon, Mojo::Server::Hypnotoad,
       Mojo::Server::Morbo, Mojo::Server::Prefork and Mojo::Server::PSGI.

EVENTS

       Mojo::Server inherits all events from Mojo::EventEmitter and can emit the following new
       ones.

   request
         $server->on(request => sub {
           my ($server, $tx) = @_;
           ...
         });

       Emitted when a request is ready and needs to be handled.

         $server->unsubscribe('request');
         $server->on(request => sub {
           my ($server, $tx) = @_;
           $tx->res->code(200);
           $tx->res->headers->content_type('text/plain');
           $tx->res->body('Hello World!');
           $tx->resume;
         });

ATTRIBUTES

       Mojo::Server implements the following attributes.

   app
         my $app = $server->app;
         $server = $server->app(MojoSubclass->new);

       Application this server handles, defaults to a Mojo::HelloWorld object.

   reverse_proxy
         my $bool = $server->reverse_proxy;
         $server  = $server->reverse_proxy($bool);

       This server operates behind a reverse proxy, defaults to the value of the
       "MOJO_REVERSE_PROXY" environment variable.

METHODS

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

   build_app
         my $app = $server->build_app('MyApp');

       Build application from class.

   build_tx
         my $tx = $server->build_tx;

       Let application build a transaction.

   daemonize
         $server->daemonize;

       Daemonize server process.

   load_app
         my $app = $server->load_app('/home/sri/myapp.pl');

       Load application from script.

         say Mojo::Server->new->load_app('./myapp.pl')->home;

   new
         my $server = Mojo::Server->new;
         my $server = Mojo::Server->new(reverse_proxy => 1);
         my $server = Mojo::Server->new({reverse_proxy => 1});

       Construct a new Mojo::Server object and subscribe to "request" event with default request
       handling.

   run
         $server->run;

       Run server. Meant to be overloaded in a subclass.

SEE ALSO

       Mojolicious, Mojolicious::Guides, <http://mojolicio.us>.