/ 
Mojolicious-5.21
River stage four • 1089 direct dependents • 1234 total dependents
⭐ Starred 2674 GitHub stars
/ Mojo::IOLoop::Server
Security Advisories (10)
CPANSA-Mojolicious-2022-03 (2022-12-10)

Mojo::DOM did not correctly parse <script> tags.

CPANSA-Mojolicious-2021-02 (2021-06-01)

Small sessions could be used as part of a brute-force attack to decode the session secret.

CVE-2021-47208 (2021-03-16)

A bug in format detection can potentially be exploited for a DoS attack.

CVE-2018-25100 (2018-02-13)

Mojo::UserAgent::CookieJar leaks old cookies because of the missing host_only flag on empty domain.

CPANSA-Mojolicious-2015-01 (2015-02-02)

Directory traversal on Windows

CPANSA-Mojolicious-2018-03 (2018-05-19)

Mojo::UserAgent was not checking peer SSL certificates by default.

CVE-2020-36829 (2020-11-10)

Mojo::Util secure_compare can leak the string length. By immediately returning when the two strings are not the same length, the function allows an attacker to guess the length of the secret string using timing attacks.

CPANSA-Mojolicious-2018-02 (2018-05-11)

GET requests with embedded backslashes can be used to access local files on Windows hosts

CPANSA-Mojolicious-2014-01 (2014-10-07)

Context sensitivity of method param could lead to parameter injection attacks.

CVE-2024-58134 (2025-05-03)

Mojolicious versions from 0.999922 for Perl uses a hard coded string, or the application's class name, as a HMAC session secret by default. These predictable default secrets can be exploited to forge session cookies. An attacker who knows or guesses the secret could compute valid HMAC signatures for the session cookie, allowing them to tamper with or hijack another user's session.

NAME

Mojo::IOLoop::Server - Non-blocking TCP server

SYNOPSIS

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;

DESCRIPTION

Mojo::IOLoop::Server accepts TCP connections for Mojo::IOLoop.

EVENTS

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

accept

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

Emitted safely for each accepted connection.

ATTRIBUTES

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

multi_accept

my $multi = $server->multi_accept;
$server   = $server->multi_accept(100);

Number of connections to accept at once, defaults to 50.

reactor

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.

METHODS

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

generate_port

my $port = $server->generate_port;

Find a free TCP port, primarily used for tests.

handle

my $handle = $server->handle;

Get handle for server.

listen

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

Create a new listen socket. Note that TLS support depends on IO::Socket::SSL (1.84+) and IPv6 support on IO::Socket::IP (0.20+).

These options are currently available:

address
address => '127.0.0.1'

Local address to listen on, defaults to all.

backlog
backlog => 128

Maximum backlog size, defaults to SOMAXCONN.

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.

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'

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

tls_ciphers
tls_ciphers => 'AES128-GCM-SHA256:RC4:HIGH:!MD5:!aNULL:!EDH'

Cipher specification string.

tls_key
tls_key => '/etc/tls/server.key'

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

tls_verify
tls_verify => 0x00

TLS verification mode, defaults to 0x03.

start

$server->start;

Start accepting connections.

stop

$server->stop;

Stop accepting connections.

SEE ALSO

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