Course of Raku / Functional, concurrent, reactive, and web programming / Web programming / A simple HTTP server

Responding to a request

Once a client has connected, you read its request and send a response. For a web browser, the response must be valid HTTP: a status line, optional headers, a blank line, and then the body.

my $listener = IO::Socket::INET.new(
    :listen,
    :localhost('127.0.0.1'),
    :localport(8080),
);

my $conn = $listener.accept;
my $request = $conn.recv;

$conn.print("HTTP/1.0 200 OK\r\nContent-Type: text/plain\r\n\r\nHello, web!");
$conn.close;
$listener.close;

The response mirrors the request format you saw on the client side. HTTP/1.0 200 OK is the status line, Content-Type: text/plain is a header, the blank line (\r\n\r\n) ends the headers, and Hello, web! is the body the browser displays.

Run this program, then open http://127.0.0.1:8080/ in a browser. You will see the text Hello, web!.

This handles a single request and then stops. To serve many requests, you would wrap the .accept-read-respond steps in a loop, and typically handle each connection on its own thread or promise so that slow clients do not block the others. But the essence of a web server is exactly this: accept a connection, read the request, write an HTTP response.

Course navigation

← Quiz — Listening   |   A hello server →

💪 Or jump directly to the exercises in this section.