Go tutorial for beginners: Build a Golang HTTP server

Q: Can I use HTTPS with this HTTP server?

Yes, you can use http.ListenAndServeTLS to serve HTTPS requests by providing a certificate and private key.

Q: How do I add more endpoints?

Register more handlers by calling http.HandleFunc with different paths and handler functions.

Q: What is the difference between http.Handle and http.HandleFunc?

http.HandleFunc simplifies registering handlers by accepting a standard function signature, while http.Handle works with objects implementing the http.Handler interface.

Learn step-by-step how to build a simple yet functional HTTP server in Golang using only the standard library. This beginner-friendly guide will walk you through setting up a project, structuring your application, and running a basic HTTP server.

Prerequisites

Before starting, ensure you have the following:

prerequisites

Go Programming Language: Installed on your system. Download it from the official Go installation page and verify it with go version.
Basic Programming Knowledge: Familiarity with concepts like functions, variables, and conditionals.
Command-Line Basics: Comfort navigating directories and running commands in a terminal.

Set Up the Environment

Initialize the project and prepare the directory structure.

steps

Create a new folder and navigate to it:
bash
```
mkdir go_http_server
cd go_http_server
```
Initialize a Go module:
bash
```
go mod init go_http_server
```
This creates a go.mod file that defines your module and tracks dependencies.
Verify the setup:
- Ensure go.mod is created within your folder.
- Check the Go version with:
  bash
```
go version
```

Create and Structure the Application

Use a standard Go project layout to keep the code organized.

file tree

go_http_server/
├── cmd/
│   └── server/
│       └── main.go
└── go.mod

cmd/server/main.go: This will hold the entry point for running the HTTP server.

Building the HTTP Server

We'll now create a minimal HTTP server using the net/http package.

steps

Navigate to the cmd/server directory:
bash
```
cd cmd/server
```
Create and edit main.go:
bash
```
nano main.go
```

Start with the following Go code:

package main

import (
    "fmt"
    "net/http"
)

// handler function that responds to HTTP requests
func helloHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello, World!")
}

func main() {
    // Register the handler function to an endpoint
    http.HandleFunc("/", helloHandler)

    // Start the HTTP server on port 8080
    fmt.Println("Starting server on :8080")
    if err := http.ListenAndServe(":8080", nil); err != nil {
        fmt.Println("Error starting server:", err)
    }
}

This code defines a helloHandler function for responding with "Hello, World!" and starts the server on port 8080.

Run the server:
bash
```
go run main.go
```
Verify the server:
- Open a browser and navigate to http://localhost:8080.
- You should see Hello, World! displayed.

Verifying the Server Setup

Debug your server and ensure the setup is functional.

Tips for troubleshooting

If the server doesn’t start, check if port 8080 is already in use. Modify the port in the http.ListenAndServe call if needed.
Use tools like Postman or curl to test endpoints programmatically:
bash
```
curl http://localhost:8080
```
Expected Output:
```
Hello, World!
```

Tips for Beginners

FAQ

Can I use HTTPS with this HTTP server?

Yes, you can use http.ListenAndServeTLS to serve HTTPS requests by providing a certificate and private key.

How do I add more endpoints?

What is the difference between http.Handle and http.HandleFunc?

http.HandleFunc simplifies registering handlers by accepting a standard function signature, while http.Handle works with objects implementing the http.Handler interface.

Official reference: Go documentation.

Related guides

Go tutorial for beginners: Build a Golang HTTP server

Prerequisites

Set Up the Environment

Create and Structure the Application

Building the HTTP Server

Verifying the Server Setup

Tips for Beginners

More guides

REST API Explained: A Beginner's Guide

Socket.IO Tutorial: Implementing Websockets in Node.js

How to Configure an Nginx Reverse Proxy