yhirose/cpp-httplib
Cpp Httplib
This is a header-only C++ library that provides implementations for HTTP clients, HTTP servers, and a WebSocket framework. It allows for the creation of network services and the consumption of remote APIs without requiring a separate compilation step or external binary linking.
The project features backend-agnostic TLS integration for secure HTTPS and WSS communication and employs a thread-pool model to process concurrent requests. It distinguishes itself with a full-duplex WebSocket state-machine and a middleware-based request pipeline that supports regular-expression path routing.
The library covers a broad range of networking capabilities, including server-sent events for real-time streaming, multipart form data parsing, and static file serving. It also includes traffic management tools for proxy routing, as well as security features such as peer certificate validation and system certificate store integration.
The implementation can be converted into C++ modules to improve compilation speeds.
Features
- C++ Networking Libraries - A header-only C++ library providing a full suite of HTTP client, server, and WebSocket implementations.
- Header-Only Libraries - Distributed as a header-only library to eliminate the need for separate compilation or binary linking.
- HTTP Client Libraries - Implements a full-featured HTTP client for sending requests and processing responses from remote servers.
- Websocket Connection Managers - Features a full-duplex state machine for managing persistent WebSocket connection lifecycles and frame exchange.
- WebSocket Clients and Servers - Implements both client and server capabilities for the bidirectional WebSocket protocol.
- HTTP Clients - Provides a comprehensive C++ HTTP client for executing network requests and managing connectivity.
- HTTP Servers - Provides a lightweight HTTP server for listening on ports and handling incoming web requests.
- Real-Time Web Communication - Provides persistent bidirectional connections for real-time data exchange via WebSockets.
- WebSocket Clients - Implements a WebSocket client for establishing bidirectional connections using secure or insecure schemes.
- WebSocket Servers - Provides a WebSocket server that listens on specified paths and manages bidirectional communication channels.
- Thread Pools - Employs a thread-pool model to distribute incoming network requests across worker threads for concurrency.
- Network Encryption - Implements TLS encryption for secure HTTPS and WSS communication through a backend-agnostic interface.
- Secure Network Communication - Implements encrypted data transfer using TLS for secure HTTPS and WSS communication.
- Embedded Web Servers - Implements a lightweight HTTP server designed to be embedded directly into C++ applications.
- HTTP Request Clients - Provides a C++ client for executing standard HTTP requests to interact with remote APIs.
- HTTP Servers - Provides a complete C++ HTTP server implementation for handling, routing, and serving web traffic.
- Request Routing - Maps incoming HTTP request URLs to specific handler functions using path-based and regular expression routing.
- Route Pattern Matching - Supports mapping incoming request URLs to handler functions via regular expression patterns.
- Response Streaming - Supports reading response bodies incrementally from the network socket to minimize memory overhead.
- Inter-Process Communication - Enables high-performance local data exchange between processes using Unix domain sockets.
- Lifecycle Request Handlers - Executes pre-request handlers to validate headers or authenticate requests before processing the body.
- Middleware-Based Request Pipelines - Utilizes a middleware pipeline to intercept and modify network requests and responses.
- Server-Sent Events - Streams real-time updates from the server to clients using a chunked provider for Server-Sent Events.
- Transport Abstractions - Abstracts the transport layer to support both TCP/IP and Unix domain sockets.
- Pluggable TLS Backends - Provides a pluggable architecture to integrate various TLS backends for secure communication.
- WebSocket Security - Provides secure WebSocket communication using the wss scheme and certificate verification.
- Response Streaming - Implements memory-efficient incremental delivery of large HTTP response bodies.
- Multipart Form Parsing - Extracts uploaded files and text fields from multipart POST requests with integrated filename sanitization.
- Incremental Body Processing - Processes incoming request data incrementally using a content receiver to avoid loading entire payloads into memory.
- Request Middleware - Implements a middleware pipeline to execute custom logic before and after the routing process.
- Web Tooling Development - Enables the creation of standalone network utilities and proxies within a single C++ binary.
- Subprotocol Negotiation - Handles the exchange of protocol headers during the WebSocket handshake to agree on specific application protocols.
- Networking - Cross-platform HTTP server/client.
- Networking and Utilities - HTTP server and client library.
- Networking Libraries - Header-only HTTP/HTTPS server library.
- Web and Networking - Cross-platform HTTP and HTTPS library.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
