🖥️ C++ Http server

🌟 Overview

This project is a lightweight web server written in C++ that efficiently handles HTTP requests without using threads. Instead, it utilizes multiplexing to manage multiple connections simultaneously. The server also supports Common Gateway Interface (CGI) for executing scripts and generating dynamic content.

✨ Features

• 🚀 Efficient handling of HTTP requests using multiplexing.
• 📄 Support for GET, POST and DELETE methods.
• ⚙️ CGI support for dynamic content generation.

📋 Requirements

• POSIX-compliant operating system (e.g., Linux, macOS)
• GNU Make

📦 Installation

git clone https://github.com/osajide/webserv.git
cd webserv

🔧 Configuration

You can configure the server by making your own configuration file. There is also a file conf/default.conf that contains an example to start with. The format of the configuration file is inspired by Nginx (not all directives).

server
{
	listen 127.0.0.1:8183 127.0.0.1:65535 127.0.0.1:8181; # This will listen on three ports
	# root /path/to/root/directory:
	root /root/of/repository/content;

	# client max body size in bytes
	client_max_body_size 200000000;

	location /
	{
		index index.html;

		# put extensions that you want your cgi to accept
		cgi py jsx php;

		allowed_methods GET POST DELETE;

		# upload_dir /path/where/to/upload, for example:
		upload_dir content/uploads;

		autoindex on; # Enable directory listing
	}
	location /cgi-bin
	{
		index forms/cgi.html;
		cgi py jsx php;

		allowed_methods GET POST DELETE;
		upload_dir content/uploads;
		autoindex on;
	}
}

❗️ Note: The mime.types file is used to define the MIME types supported by the server. To add a new MIME type, simply add it to this file conf/mime.types. For example:

# mime.types

text/html                            html;
text/css                             css;
image/png                            png;
...
# Add new MIME types here
video/mp4                            mp4;
image/webp                           webp;

🚀 Launch the server

1️⃣ Build the project:

make

2️⃣ Run the server with the executable and path to the configuration file:

./webserv /path/to/your/config

You can also use:

./webserv

And the default configuration will be used. The server will start listening on the port specified in the configuration file.

3️⃣ Test the server:

If you're using the default configuration conf/default.conf you can test the server on:

http://localhost:8183

You will be able to see this page:

Or if you're using your own configuration file, do this instead:

http://localhost:<port_specified_in_your_config>