mirror of
https://github.com/yhirose/cpp-httplib.git
synced 2026-08-19 16:45:03 +00:00
8f0ff32056
T04 (mTLS) had grown a "WebSocketClient" subsection describing wss:// client certificates, and c12/t02 were getting similar WebSocketClient asides for timeouts and CA paths. The Cookbook's own index already separates WebSocket into its own category (W01-W04) from TLS/Security (T01-T05) and Client (C01-C19), so burying WebSocketClient specifics inside those pages fought the site's structure. Move that content into two new recipes under the WebSocket category instead: - W05: wss:// TLS setup (set_ca_cert_path CA directory parity, PemMemory client certificate) - W06: WebSocketClient's three timeouts, including the recently added chrono overloads T04, T02, C12, and W01 now carry a single reference link to the new pages instead of duplicated explanations, matching the site's existing cross-link convention. While rewriting T04's client-side section, noticed it documented SSLClient's file-path constructor but not its PemMemory one, even though the server-side section covered both forms for SSLServer. Added the missing PemMemory example so both sides are symmetric.
3.6 KiB
3.6 KiB
title, order, status
| title | order | status |
|---|---|---|
| Cookbook | 0 | draft |
A collection of recipes that answer "How do I...?" questions. Each recipe is self-contained — read only what you need. For an introduction to the basics, see the Tour.
Client
Basics
- C01. Get the response body / save to a file
- C02. Send and receive JSON
- C03. Set default headers
- C04. Follow redirects
Authentication
File Upload
- C07. Upload a file as multipart form data
- C08. POST a file as raw binary
- C09. Send the body with chunked transfer
Streaming & Progress
Connection & Performance
- C12. Set timeouts
- C13. Set an overall timeout
- C14. Understand connection reuse and Keep-Alive behavior
- C15. Enable compression
- C16. Send requests through a proxy
Error Handling & Debugging
Server
Basics
- S01. Register GET / POST / PUT / DELETE handlers
- S02. Receive JSON requests and return JSON responses
- S03. Use path parameters
- S04. Set up a static file server
Streaming & Files
- S05. Stream a large file in the response
- S06. Return a file download response
- S07. Receive multipart data as a stream
- S08. Return a compressed response
Handler Chain
- S09. Add pre-processing to all routes
- S10. Add response headers with a post-routing handler
- S11. Authenticate per route with a pre-request handler
- S12. Pass data between handlers with
res.user_data
Error Handling & Debugging
- S13. Return custom error pages
- S14. Catch exceptions
- S15. Log requests
- S16. Detect client disconnection
Operations & Tuning
- S17. Bind to any available port
- S18. Control startup order with
listen_after_bind - S19. Shut down gracefully
- S20. Tune Keep-Alive
- S21. Configure the thread pool
- S22. Talk over a Unix domain socket
TLS / Security
- T01. Choosing between OpenSSL, mbedTLS, and wolfSSL
- T02. Control SSL certificate verification
- T03. Start an SSL/TLS server
- T04. Configure mTLS
- T05. Access the peer certificate on the server
SSE
- E01. Implement an SSE server
- E02. Use named events in SSE
- E03. Handle SSE reconnection
- E04. Receive SSE on the client