A lightweight HTTP/1.1 compliant web server supporting static file serving, CGI execution, and virtual hosts.
-
HTTP/1.1 Compliance
GET,POST,DELETEmethods- Keep-alive connections
- Status codes per RFC standards
-
Core Functionality
- Static file serving
- Directory listing
- File uploads
- CGI execution
- Virtual host support
-
Performance
- Non-blocking I/O
- Single
select()multiplexing - Connection pooling
- Memory-efficient design
-
Configuration
- Multiple port binding
- Custom error pages
- Route-based rules
- Directory restrictions
- Upload size limits
sequenceDiagram participant Client participant Listener as Server Listener participant Poller as Polling Mechanism participant Handler as Request Handler participant Router participant Methods as HTTP Methods participant Static as Static File Server participant CGI as CGI Handler participant Error as Error Handler participant Response as Response Generator Client->>Listener: Connect to Server Listener->>Poller: Register Socket Poller-->>Listener: Socket Ready Listener->>Handler: Accept Connection Handler->>Poller: Register Client Socket Poller-->>Handler: Data Ready Handler->>Client: Read HTTP Request Handler->>Router: Parse Request Router->>Router: Match Route alt Request Type opt Static Content Router->>Static: Retrieve File Static-->>Handler: Serve File end opt Execute CGI Router->>CGI: Run Script CGI-->>Handler: CGI Output end opt Unsupported Method Router->>Error: Generate Error Error-->>Handler: Error Response end end Handler->>Response: Generate HTTP Response Response->>Client: Send Response Client-->>Handler: Acknowledgment Handler->>Poller: Remove Socket if Done 
# Build the server make # Run with default config ./webserv config/default.conf # Test basic functionality curl http://localhost:8080/server { port 8080; server_name localhost; root /var/www; location / { index index.html; methods GET POST; } location /cgi-bin { allowed_methods GET POST; client_max_body_size 10M; cgi_pass /usr/bin/python3; } }- C++98 compiler
- POSIX-compliant system
- CMake 3.0+ (for building)
> siege -b 127.0.0.1:8080/empty.html -t10s # macOS Transactions: 136047 hits Availability: 100.00 % Elapsed time: 10.76 secs Data transferred: 0.00 MB Response time: 1.97 ms Transaction rate: 12643.77 trans/sec Throughput: 0.00 MB/sec Concurrency: 24.89 Successful transactions: 136047 Failed transactions: 0 Longest transaction: 30.00 ms Shortest transaction: 0.00 ms # ubuntu Transactions: 94641 hits Availability: 100.00 % Elapsed time: 9.56 secs Data transferred: 0.00 MB Response time: 0.00 ms Transaction rate: 9899.69 trans/sec Throughput: 0.00 MB/sec Concurrency: 24.61 Successful transactions: 94641, Failed transactions: 0 Longest transaction: 0.01 ms Shortest transaction: 0.00 msThis project is part of the 42 school curriculum.