webserv/htdocs/site-2/examples/README.md

Welcome to WebServ Examples Directory

This directory contains example files and configurations to demonstrate various features of the WebServ HTTP server.

Files in this directory:

webserv.conf - Complete example configuration file README.md - This file test.txt - Simple text file for testing sample.html - Basic HTML page large-file.dat - Larger file for testing file serving performance

Configuration Examples:

The webserv.conf file demonstrates:

• Multiple server blocks
• Virtual host configuration
• SSL/HTTPS setup
• Static file serving
• API endpoint configuration
• Directory listing
• Custom error pages
• Security headers
• Caching strategies

Testing Examples:

You can test various server features using these files:

1. Static File Serving: curl http://localhost:8080/examples/test.txt

2. HTML Content: curl http://localhost:8080/examples/sample.html

3. Directory Listing: curl http://localhost:8080/examples/

4. Large File Download: curl -O http://localhost:8080/examples/large-file.dat

5. Error Handling: curl http://localhost:8080/examples/nonexistent.html

Performance Testing:

Use tools like Apache Bench (ab) or wrk to test performance:

ab -n 1000 -c 10 http://localhost:8080/examples/test.txt wrk -t4 -c100 -d30s http://localhost:8080/examples/

Security Testing:

Test various security scenarios:

1. Directory traversal attempts: curl http://localhost:8080/examples/../../../etc/passwd

2. Hidden file access: curl http://localhost:8080/examples/.htaccess

3. Backup file access: curl http://localhost:8080/examples/config.php~

All these should be properly blocked by WebServ's security features.

For more information, visit the WebServ documentation.