GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Mojo::IOLoop::Server(3) User Contributed Perl Documentation Mojo::IOLoop::Server(3)

Mojo::IOLoop::Server - Non-blocking TCP and UNIX domain socket server

  use Mojo::IOLoop::Server;

  # Create listen socket
  my $server = Mojo::IOLoop::Server->new;
  $server->on(accept => sub ($server, $handle) {...});
  $server->listen(port => 3000);

  # Start and stop accepting connections
  $server->start;
  $server->stop;

  # Start reactor if necessary
  $server->reactor->start unless $server->reactor->is_running;

Mojo::IOLoop::Server accepts TCP/IP and UNIX domain socket connections for Mojo::IOLoop.

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

  $server->on(accept => sub ($server, $handle) {...});

Emitted for each accepted connection.

Mojo::IOLoop::Server implements the following attributes.

  my $reactor = $server->reactor;
  $server     = $server->reactor(Mojo::Reactor::Poll->new);

Low-level event reactor, defaults to the "reactor" attribute value of the global Mojo::IOLoop singleton. Note that this attribute is weakened.

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

  my $port = Mojo::IOLoop::Server->generate_port;

Find a free TCP port, primarily used for tests.

  my $handle = $server->handle;

Get handle for server, usually an IO::Socket::IP object.

  my $bool = $server->is_accepting;

Check if connections are currently being accepted.

  $server->listen(port => 3000);
  $server->listen({port => 3000});

Create a new listen socket. Note that TLS support depends on IO::Socket::SSL (2.009+).

These options are currently available:

address
  address => '127.0.0.1'
    

Local address to listen on, defaults to 0.0.0.0.

backlog
  backlog => 128
    

Maximum backlog size, defaults to "SOMAXCONN".

fd
  fd => 3
    

File descriptor with an already prepared listen socket.

path
  path => '/tmp/myapp.sock'
    

Path for UNIX domain socket to listen on.

port
  port => 80
    

Port to listen on, defaults to a random port.

reuse
  reuse => 1
    

Allow multiple servers to use the same port with the "SO_REUSEPORT" socket option.

single_accept
  single_accept => 1
    

Only accept one connection at a time.

tls
  tls => 1
    

Enable TLS.

tls_ca
  tls_ca => '/etc/tls/ca.crt'
    

Path to TLS certificate authority file.

tls_cert
  tls_cert => '/etc/tls/server.crt'
  tls_cert => {'mojolicious.org' => '/etc/tls/mojo.crt'}
    

Path to the TLS cert file, defaults to a built-in test certificate.

tls_key
  tls_key => '/etc/tls/server.key'
  tls_key => {'mojolicious.org' => '/etc/tls/mojo.key'}
    

Path to the TLS key file, defaults to a built-in test key.

tls_options
  tls_options => {SSL_alpn_protocols => ['foo', 'bar'], SSL_verify_mode => 0x00}
    

Additional options for IO::Socket::SSL.

  my $port = $server->port;

Get port this server is listening on.

  $server->start;

Start or resume accepting connections.

  $server->stop;

Stop accepting connections.

Mojolicious, Mojolicious::Guides, <https://mojolicious.org>.
2021-12-08 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.