This project is about writing our own HTTP/1.1-compliant web server in C++, with non-blocking I/O and support for various web server features. It is part of the 42 School curriculum and follows strict coding standards.
- multipart/form-data file upload
- CGI support
- HTTP/1.1 compliant
- Keep-Alive connections
- Custom error pages
- Autoindexing
- Custom configuration file
- Internal API for metrics data and can be used to control the server
- Support for multiple server blocks
- virtual server matching based on
listenandserver_name - Persistent Sessions
- Cookies
- Smart Buffer Management, when a buffer for example the request body is not large enough to hold the entire request body in memory, it will be saved in a temporary file, this way we can handle large requests without running out of memory.
- php-cgi support, we prepared a little example for running wordpress with our webserv
- Support for custom error pages, you can define custom error pages for different HTTP status codes in the configuration file.
- Redirects, you can define redirects in the configuration file
- Transfer-Encoding: chunked support, the server can handle chunked transfer encoding requests and responses
Clone the project
git clone https://github.com/peu77/webserv.gitGo to the project directory
cd webservStart the server
make
./webserv config.yamlThe server is configured using a custom nginx-style configuration file.
http{
client_max_header_count 100;
client_max_header_size 1MB;
server {
listen 8080;
server_name localhost;
client_max_body_size 200MB;
client_max_header_size 10KB;
location /{
return 200 "Hello, World!";
}
}
}Specified within the http block. The server will use the first matching HTTP options.
| directive | description | example |
|---|---|---|
client_max_header_count |
maximum number of headers | 100 |
client_max_header_size |
maximum header size | 1MB |
client_header_timeout |
timeout for client header | 10 |
max_request_line_size |
maximum request line size | 1MB |
server |
server block | server {...} |
Specified within a server block. The server will use all matching server options.
Defining multiple server blocks with identical listen and server_name values is prohibited and will cause a configuration parsing failure.
| directive | description | example |
|---|---|---|
listen |
ip and/or port to listen on | 0.0.0.0:8080 |
server_name |
server name | localhost |
root |
root directory | /www |
index |
default index file | /index.html |
client_max_body_size |
maximum body size | 1024MB |
client_body_timeout |
timeout for client body | 10 |
client_header_timeout |
timeout for client header | 10 |
client_max_header_size |
maximum header size | 10KB |
client_max_header_count |
maximum number of headers | 100 |
cgi_timeout |
timeout for CGI scripts | 10 |
keepalive_timeout |
timeout for keepalive connections | 10 |
keepalive_requests |
maximum number of keepalive requests | 100 |
error_page |
custom error page (<code> <filepath>) |
404 /404.html |
internal_api |
enable internal API | on |
location |
location block | location / {...} |
Specified within a location block. The server will use all matching location options.
| directive | description | example |
|---|---|---|
root |
root directory | /www |
index |
default index file | /index.html |
autoindex |
enable autoindex | on |
alias |
alias for the location | /alias |
allow_methods |
allowed methods | GET POST DELETE |
deny |
deny access to the location | on |
error_page |
custom error page (<code> <filepath>) |
404 /404.html |
return |
costom return code and message (<code> <message>), can be usesd for redirects |
404 Not Found |
cgi |
cgi script (<ext> <path>) |
.php /usr/bin/php |