https://github.com/tur1ng7/httpserver
A lightweight and educational HTTP server built using C++ from scratch to demonstrate the fundamentals of web server functionality.
https://github.com/tur1ng7/httpserver
c cmake cpp http-server http-server-from-scratch networking web-development webserver webserver-setup
Last synced: 11 months ago
JSON representation
A lightweight and educational HTTP server built using C++ from scratch to demonstrate the fundamentals of web server functionality.
- Host: GitHub
- URL: https://github.com/tur1ng7/httpserver
- Owner: Tur1ng7
- License: mit
- Created: 2024-12-23T17:09:59.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-23T17:35:40.000Z (about 1 year ago)
- Last Synced: 2025-02-21T05:15:38.310Z (11 months ago)
- Topics: c, cmake, cpp, http-server, http-server-from-scratch, networking, web-development, webserver, webserver-setup
- Language: C++
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HttpServer
A simple, lightweight HTTP server built from scratch using C++ to understand the fundamentals of web servers, routing, handling HTTP requests, and responses. This server supports basic routing, serving dynamic HTML content, and can be extended to serve static files (if needed in the future).
## Features
- Basic HTTP server functionality with support for dynamic routing.
- A custom thread pool to handle multiple client requests concurrently.
- Logging system to track client connections and responses.
- Lightweight and easy to extend for further learning and experimentation.
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Resources Used](#resources-used)
## Installation
### Prerequisites
- C++ compiler (G++ or Clang)
- CMake (version 3.10 or later)
- Make
- Linux or macOS for development, Windows (with WSL or similar) should work as well.
### Steps to Build and Run
1. Clone the repository to your local machine:
```bash
git clone https://github.com/Tur1ng7/HttpServer.git
cd HttpServer
```
2. Create a build directory and navigate into it:
```bash
mkdir build
cd build
```
3. Run CMake to configure the project:
```bash
cmake ..
```
4. Build the project using Make:
```bash
make
```
5. After the build is complete, you can run the server:
```bash
./HttpServer
```
The server will start running on port 8080 by default. You can access it in your browser or via curl:
```bash
curl http://localhost:8080
```
## Usage
Once the server is running, you can interact with it by visiting the following endpoints in your browser:
- `http://localhost:8080/` – Returns a simple greeting message.
- `http://localhost:8080/hello` – Returns a welcome message on the `/hello` route.
### Example Request
```bash
curl http://localhost:8080/hello
```
This will return a response with the message: "Welcome to the /hello endpoint!"
## Resources Used
- **[man Command](https://www.ibm.com/docs/en/aix/7.1?topic=m-man-command&mhsrc=ibmsearch_a&mhq=man%20command)**
- **[MDN Web Docs](https://developer.mozilla.org/en-US/)**
- **[cppreference](https://en.cppreference.com/w/)**
- **[CMake](https://cmake.org/)**