Mojo::IOLoop::Server - Non-blocking TCP server
use Mojo::IOLoop::Server; # Create listen socket my $server = Mojo::IOLoop::Server->new; $server->on(accept => sub { my ($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 connections for Mojo::IOLoop.
Mojo::IOLoop::Server inherits all events from Mojo::EventEmitter and can emit the following new ones.
$server->on(accept => sub { my ($server, $handle) = @_; ... });
Emitted for each accepted connection.
Mojo::IOLoop::Server implements the following attributes.
my $multi = $server->multi_accept; $server = $server->multi_accept(100);
Number of connections to accept at once, defaults to 50.
50
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.
reactor
Mojo::IOLoop::Server inherits all methods from Mojo::EventEmitter and implements the following new ones.
my $port = $server->generate_port;
Find a free TCP port, primarily used for tests.
my $handle = $server->handle;
Get handle for server.
$server->listen(port => 3000);
Create a new listen socket. Note that TLS support depends on IO::Socket::SSL (1.94+).
These options are currently available:
address => '127.0.0.1'
Local address to listen on, defaults to 0.0.0.0.
0.0.0.0
backlog => 128
Maximum backlog size, defaults to SOMAXCONN.
SOMAXCONN
port => 80
Port to listen on, defaults to a random port.
reuse => 1
Allow multiple servers to use the same port with the SO_REUSEPORT socket option.
SO_REUSEPORT
tls => 1
Enable TLS.
tls_ca => '/etc/tls/ca.crt'
Path to TLS certificate authority file.
tls_cert => '/etc/tls/server.crt'
Path to the TLS cert file, defaults to a built-in test certificate.
tls_ciphers => 'AES128-GCM-SHA256:RC4:HIGH:!MD5:!aNULL:!EDH'
TLS cipher specification string. For more information about the format see https://www.openssl.org/docs/manmaster/apps/ciphers.html#CIPHER-STRINGS.
tls_key => '/etc/tls/server.key'
Path to the TLS key file, defaults to a built-in test key.
tls_verify => 0x00
TLS verification mode, defaults to 0x03.
0x03
tls_version => 'TLSv1_2'
TLS protocol version.
my $port = $server->port;
Get port this server is listening on.
$server->start;
Start accepting connections.
$server->stop;
Stop accepting connections.
Mojolicious, Mojolicious::Guides, http://mojolicio.us.
To install Mojolicious, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mojolicious
CPAN shell
perl -MCPAN -e shell install Mojolicious
For more information on module installation, please visit the detailed CPAN module installation guide.