NAME¶

Mojo::IOLoop::Stream::HTTPServer - Non-blocking I/O HTTP server stream

SYNOPSIS¶

  use Mojo::IOLoop::Server;
  use Mojo::IOLoop::Stream::HTTPServer;
  
  # Create listen socket
  my $server = Mojo::IOLoop::Server->new;
  $server->on(
    accept => sub {
      my $stream = Mojo::IOLoop::Stream::HTTPServer->new(pop);
  
      $stream->on(
        request => sub {
          my ($stream, $tx) = @_;
          $tx->res->code(200);
          $tx->res->headers->content_type('text/plain');
          $tx->res->body('Hello World!');
          $tx->resume;
        }
      );
      $stream->start;
    }
  );
  $server->listen(port => 3000);
  
  # Start reactor if necessary
  $stream->reactor->start unless $stream->reactor->is_running;

DESCRIPTION¶

Mojo::IOLoop::Stream::HTTPServer is a container for I/O streams used by Mojo::IOLoop to support the HTTP protocol server-side.

EVENTS¶

Mojo::IOLoop::Stream::HTTPServer inherits all events from Mojo::IOLoop::Stream and can emit the following new ones.

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

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

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

  $stream->on(upgrade => sub {
    my ($stream, $ws) = @_;
    ...
  });

ATTRIBUTES¶

Mojo::IOLoop::Stream::HTTPServer inherits all attributes from Mojo::IOLoop::Stream and implements the following ones.

  my $app = $stream->app;
  $stream = $stream->app(Mojolicious->new);

  my $max = $stream->max_requests;
  $stream = $stream->max_requests(250);

METHODS¶

Mojo::IOLoop::Stream::HTTPServer inherits all methods from Mojo::IOLoop::Stream and implements the following new ones.

  my $stream = Mojo::IOLoop::Stream::HTTPServer->new($handle);

DEBUGGING¶

You can set the "MOJO_SERVER_DEBUG" environment variable to get some advanced diagnostics information printed to "STDERR".

  MOJO_SERVER_DEBUG=1

SEE ALSO¶

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