Mojo::Server(3)

💖 NAME

Mojo::Server — the HTTP/WebSocket server base class. That’s the whole name vibe, periodt. 👑

✨ SYNOPSIS

okay so if ur building ur own server subclass, it looks like this:

package Mojo::Server::MyServer;
use Mojo::Base 'Mojo::Server', -signatures;

sub run ($self) {

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

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

🎀 DESCRIPTION

So Mojo::Server is an abstract base class for HTTP/WebSocket servers and server interfaces — the whole squad includes Mojo::Server::CGI, Mojo::Server::Daemon, Mojo::Server::Hypnotoad, Mojo::Server::Morbo, Mojo::Server::Prefork, and Mojo::Server::PSGI. It’s giving “base class that runs the friend group” energy. 💅

🔥 EVENTS

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

request

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

Emitted when a request is ready and needs to be handled. Like, the moment has arrived and the request needs its moment. ✨

$server->on(request => sub ($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. Main character app energy, honestly. 🫶

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 or true if trusted_proxies is not empty. Proxy vibes: acknowledged. 🌈

trusted_proxies

my $proxies = $server->trusted_proxies;
$server     = $server->trusted_proxies(['10.0.0.0/8', '127.0.0.1', '172.16.0.0/12', '192.168.0.0/16', 'fc00::/7']);

This server expects requests from trusted reverse proxies, defaults to the value of the MOJO_TRUSTED_PROXIES environment variable split on commas with optional whitespace. These proxies should be addresses or networks in CIDR form. Trusted proxy squad only, no randoms. 💜

🧚 METHODS

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

build_app

my $app = $server->build_app('MyApp');
my $app = $server->build_app('MyApp', log => Mojo::Log->new);
my $app = $server->build_app('MyApp', {log => Mojo::Log->new});

Build application from class and assign it to app. Build-a-bear but make it application. 🎀

build_tx

my $tx = $server->build_tx;

Let application build a transaction. Simple as that, bestie. ✨

daemonize

$server->daemonize;

Daemonize server process. Bye-bye foreground vibes, hello background icon behavior. 💅

load_app

my $app = $server->load_app('/home/sri/myapp.pl');
my $app = $server->load_app('/home/sri/myapp.pl', log => Mojo::Log->new);
my $app = $server->load_app('/home/sri/myapp.pl', {log => Mojo::Log->new});

Load application from script and assign it to app. Loading screen but make it Perl. 🌸

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 the request event with default request handling. Constructor slay. 🔥

run

$server->run;

Run server. Meant to be overloaded in a subclass — do ur own thing, bestie. 👑

🦋 SEE ALSO

• Mojolicious
• Mojolicious::Guides
• <https://mojolicious.org>

---

💖 source/version: perl v5.42.0 — date: 2026-07-15 — and yes, this whole page is Mojo::Server(3), bye bestie! 💖