后端网络【免费下载链接】cpp-httplibA C header-only HTTP/HTTPS server and client library项目地址https://gitcode.com/GitHub_Trending/cp/cpp-httplib点击查看免费下载导读本文基于 cpp-httplib 官方文档的 Cookbook 索引页docs-src/pages/ja/cookbook/index.md系统梳理了该项目面向实战的全部「怎么做」How do I...?配方客户端C01–C19、服务器S01–S23、TLS/安全T01–T05、SSEE01–E04与 WebSocketW01–W06五大板块。每个配方相互独立可单独查阅读完本文你将掌握 cpp-httplib 在鉴权、文件上传、流式传输、连接管理、错误处理、协议扩展等场景下的标准解法并能直接定位到对应源码与示例。关于基础用法的入门介绍请参阅 Tour 教程。一、Cookbook 的整体结构如何按需检索Cookbook 的设计原则是「每个配方自包含self-contained只读你需要的页面」。它按主题划分为五个大区每个大区下再按用途细分板块编号范围覆盖主题篇数客户端ClientC01–C19响应获取、JSON、鉴权、文件上传、流式传输、连接性能、错误处理19服务器ServerS01–S23路由注册、JSON API、静态文件、流式响应、处理器链、运维调优、协议扩展23TLS / 安全T01–T05TLS 后端选型、证书校验、SSL 服务器、mTLS、对端证书5SSEE01–E04SSE 服务器、事件名、重连、客户端接收4WebSocketW01–W06回显服务器、心跳、关闭、二进制帧、TLS、超时6这种编号体系本身就是一张「问题 → 解法」的映射表例如你想知道「如何给客户端设置超时」直接找 C12想了解「如何在服务端实现优雅停机」直接看 S19。下文按板块展开并对每个配方给出核心思路与源码佐证。二、客户端配方C01–C192.1 基本操作C01–C04C01获取响应体 / 保存到文件c01-get-response-body.md以字符串获取res-body是std::string可直接使用但整个响应会被加载进内存httplib::Client cli(http://localhost:8080); auto res cli.Get(/hello); if (res res-status 200) { std::cout res-body std::endl; }大文件应改用ContentReceiver逐块接收并直接写入文件避免内存占用std::ofstream ofs(output.bin, std::ios::binary); auto res cli.Get(/large-file, { ofs.write(data, len); return static_castbool(ofs); // false 则中断下载 });回调返回false即可中止下载若需在下载前查看Content-Length等头部可组合ResponseHandler在收到头部后、读取正文前被调用返回false可跳过整个下载。下载进度则参见 C11。C02收发 JSONc02-json.mdcpp-httplib 自身不含 JSON 解析器需配合 nlohmann/json 等库nlohmann::json j {{name, Alice}, {age, 30}}; auto res cli.Post(/api/users, j.dump(), application/json);发送时第 2 参数为 JSON 字符串、第 3 参数为 Content-TypePut()/Patch()同构接收时直接nlohmann::json::parse(res-body)。注意Content-Type 必须显式指定application/json否则服务端可能不按 JSON 处理解析前应先检查状态码防止服务端错误时返回 HTML 导致解析异常。C03设置默认头c03-default-headers.mdset_default_headers()一次性登记所有请求共用的头部如Accept、User-Agent、Authorizationcli.set_default_headers({ {Accept, application/json}, {User-Agent, my-app/1.0}, });从源码看该方法对应 httplib.h 中ClientImpl的default_headers_成员调用即整体覆写该集合见 ClientImpl::set_default_headers因此追加单个头时也需传回完整集合。请求级通过Headers传入的头会与默认头合并发送二者可叠加使用。C04跟随重定向c04-follow-location.mdcpp-httplib 默认不跟随3xx 重定向302会原样返回调用cli.set_follow_location(true)后客户端会依据Location头自动重发请求httplib::Client cli(http://example.com); cli.set_follow_location(true); auto res cli.Get(/old-path); // 最终响应进入 res该方法在源码中对应follow_location_标志位ClientImpl::set_follow_location并支持跨 scheme/host 跳转如 HTTP→HTTPS。前提是库已以 OpenSSL 或其他 TLS 后端编译否则无法跟随到 HTTPS。跟随重定向会拉长请求耗时超时设置参考 C12。2.2 认证C05–C06C05Basic 认证c05-basic-auth.mdset_basic_auth(alice, s3cret)让库自动组装Authorization: Basic ...头对应 ClientImpl::set_basic_auth也可用httplib::make_basic_authentication_header()生成 Base64 编码头实现请求级认证。安全警告Basic 仅做 Base64 编码而非加密必须走 HTTPS。更安全的 Digest 认证用set_digest_auth()该方法仅在以 OpenSSL 等 TLS 后端构建时可用ClientImpl::set_digest_auth。C06Bearer Token 调用 APIc06-bearer-token.mdset_bearer_token_auth(token)自动组装Authorization: Bearer tokenClientImpl::set_bearer_token_auth适合 OAuth 2.0 类 API请求级可用make_bearer_token_authentication_header()。Token 过期后只需用新 Token 再次调用set_bearer_token_auth()即可刷新。警告Bearer Token 本身即凭证务必 HTTPS 传输且不要硬编码进源码。2.3 文件上传C07–C09C07multipart/form-data 上传c07-multipart-upload.md按文件大小二选一小文件先整体读入内存用UploadFormDataItems元素结构为{name, content, filename, content_type}文本字段把后两项留空httplib::UploadFormDataItems items { {name, Alice, , }, {avatar, content, avatar.png, image/png}, }; auto res cli.Post(/upload, items);大文件用FormDataProviderItemsmake_file_provider(表单名, 文件路径, 文件名, Content-Type)流式发送make_file_provider不占内存文件名传空则用文件路径。两类 items 可在同一请求中混用——文本字段走UploadFormDataItems、文件走FormDataProviderItems是推荐做法。C08以原始二进制 POST 文件c08-post-file-body.md用于 S3 兼容 API、原始图像上传等「正文即文件」的场景。make_file_body()返回(size, ContentProvider)对make_file_body可直接喂给Put()/Post()auto [size, provider] httplib::make_file_body(backup.tar.gz); if (size 0) { /* 文件打开失败 */ } auto res cli.Put(/bucket/backup.tar.gz, size, provider, application/gzip);ContentProvider按块读文件内存友好但该 API 需预先确定 Content-Length不适合发送过程中大小会变化的文件。C09Chunked 传输正文c09-chunked-upload.md适用于无法预知正文总长度的场景如实时生成的数据流用ContentProvider配合 chunked transfer 逐块发送。2.4 流式与进度C10–C11C10 流式接收响应c10-stream-response.md通过ContentReceiver逐块处理响应避免整包入内存。C11 进度回调c11-progress-callback.mdset_progress_callback()可同时获得上传/下载字节数用于实现进度条常与 C07、C08 的大文件传输配合。2.5 连接与性能C12–C16C12 超时设置c12-timeouts.mdset_connection_timeout()、set_read_timeout()、set_write_timeout()分别控制建连、读、写超时。C13 整体超时c13-max-timeout.mdset_connection_timeout()之外整体超时overall timeout用于约束整个请求的总时长适合慢接口兜底。C14 Keep-Alive 与连接复用c14-keep-alive.md理解连接池复用行为避免反复握手set_keep_alive_max_count()可限制单连接最大请求数。C15 压缩c15-compression.mdset_compress(true)开启 gzip 压缩需要库以 zlib/brotli 构建CMake 侧见 cmake/FindBrotli.cmake。C16 代理c16-proxy.mdset_proxy(host, port)设置 HTTP 代理项目测试目录 test/proxy 提供了基于 Squid httpbin 的代理测试环境docker-compose.ci.yml可用于 CI 验证。2.6 错误处理与调试C17–C19C17 错误码c17-error-codes.md请求失败时res为nullptr可用cli.get_last_error()/cli.get_error()获取Error枚举连接失败、超时、TLS 错误等据此区分失败类别。C18 SSL 错误c18-ssl-errors.md针对证书校验失败、握手失败等 TLS 专项错误的处理套路。C19 客户端日志c19-client-logger.mdset_logger()注册日志回调记录请求行与响应状态便于排查。三、服务器配方S01–S233.1 基本路由S01–S04S01注册 GET / POST / PUT / DELETE 处理器s01-handlers.md处理器签名统一为(const Request, Response)httplib::Server svr; svr.Get(/hello, [](const httplib::Request req, httplib::Response res) { res.set_content(Hello, World!, text/plain); }); svr.Post(/api/items, [](const httplib::Request req, httplib::Response res) { // req.body 即请求正文 res.status 201; res.set_content(Created, text/plain); }); svr.listen(0.0.0.0, 8080); // 阻塞启动res.set_content()设置正文与 Content-Typeres.status设置状态码。查询参数用req.get_param_value(q)先查存在性用req.has_param()请求头用req.get_header_value(User-Agent)响应头用res.set_header(Name, Value)。listen()是阻塞调用需并行启动时见 S18。S02JSON 请求 / 响应s02-json-api.md服务端从req.body取 JSON 字符串交给 JSON 库解析用res.set_content(j.dump(), application/json)返回与客户端 C02 对称。S03路径参数s03-path-params.md路由模式/users/:id中的:id可用req.path_params或req.get_param_value系方法取出。S04静态文件服务器s04-static-files.mdsvr.set_mount_point(/, ./public)将本地目录挂载为静态资源项目测试用 test/www、test/www2、test/www3 三套目录验证挂载行为含中文目录名、空文件等边界。3.2 流式与文件S05–S08S05 流式返回大文件s05-stream-response.mdres.set_content_provider()/set_chunked_content_provider()配合DataSink分块写出避免大文件整体入内存。S06 下载响应s06-download-response.mdres.set_content_provider()Content-Disposition: attachment头让浏览器/客户端以附件形式保存。S07 流式接收 multiparts07-multipart-reader.mdMultipartFormDataMap与流式读取 API 处理上传表单与客户端 C07 对应。S08 压缩响应s08-compress-response.mdres.set_content_provider配合set_compress在服务端开启 gzip/brotli 输出。3.3 处理器链S09–S12S09 全路由前置处理s09-pre-routing.mdsvr.set_pre_routing_handler()在路由分发前统一处理如全局限流、CORS。S10 Post-routing 追加响应头s10-post-routing.mdsvr.set_post_routing_handler()在路由处理后统一附加头部。S11 Pre-request 按路由鉴权s11-pre-request.mdsvr.set_pre_routing_handler()结合req.path实现路由级认证对应客户端 C05/C06 的认证头。S12res.user_data传递数据s12-user-data.md处理器间通过res.user_datastd::any共享数据典型用于 pre-routing 注入用户信息、后续处理器消费。3.4 错误处理与调试S13–S16S13 自定义错误页s13-error-handler.mdsvr.set_error_handler()统一接管 4xx/5xx 的响应体与状态码。S14 捕获异常s14-exception-handler.mdsvr.set_exception_handler()捕获处理器抛出的std::exception避免连接被直接关闭。S15 请求日志s15-server-logger.mdsvr.set_logger()记录每个请求的 method、path、状态码与耗时。S16 检测客户端断开s16-disconnect.mdreq.is_connection_closed()判断长连接是否已断开用于提前终止流式输出。3.5 运维与调优S17–S22S17 动态端口s17-bind-any-port.mdsvr.bind_to_any_port(0.0.0.0)后由svr.port()读取实际分配端口适合测试与端口自动协商。S18listen_after_bind控制启动顺序s18-listen-after-bind.md先bind()后listen_after_bind()可在监听前完成端口获取、初始化等工作也是非阻塞启动的关键。S19 优雅停机s19-graceful-shutdown.md在另一线程调用svr.stop()配合wait_until_ready()/is_running()实现可控关停。S20 调优 Keep-Alives20-keep-alive.mdsvr.set_keep_alive_max_count()控制单连接可处理的请求数平衡连接复用与资源释放。S21 线程池s21-thread-pool.mdsvr.new_task_queue [] { return new httplib::ThreadPool(n, m); }指定工作线程上下限ThreadPool实现位于 httplib.h 内部线程池部分另有独立测试 test/test_thread_pool.cc。S22 Unix domain sockets22-unix-socket.mdsvr.listen(/path/to/sock)让服务器监听 Unix socket供同机进程间通信。3.6 协议扩展S23S23自定义 HTTP 方法s23-custom-methods.md对PROPFIND等非内置方法用svr.CustomRoute(PROPFIND, /path, handler)注册实现 WebDAV 等扩展协议。四、TLS / 安全T01–T05T01 TLS 后端选型t01-tls-backends.mdcpp-httplib 支持 OpenSSL、mbedTLS、wolfSSL 三种后端按平台生态、证书管理、体积等维度选择CMake 构建配置见 cmake/modules.cmake 与顶层 CMakeLists.txt。T02 证书校验控制t02-cert-verification.mdcli.enable_server_certificate_verification(true)与cli.set_ca_cert_path()管理 CA 信任链。T03 启动 SSL/TLS 服务器t03-ssl-server.mdhttplib::SSLServer svr; svr.set_cert_file(...); svr.set_key_file(...)配置证书密钥后正常注册路由。T04 配置 mTLSt04-mtls.mdset_ca_cert_file()要求客户端证书实现双向认证客户端侧对应set_client_cert_path()/set_client_key_path()。T05 服务端读取对端证书t05-peer-cert.md通过SSLServer请求上下文获取对端证书信息如 CN、SAN用于细粒度授权。证书生成脚本见 test/gen-certs.shTLS 测试覆盖于 test/test.cc。五、SSEE01–E04SSEServer-Sent Events是服务器向客户端单向推送的轻量协议cpp-httplib 没有 SSE 专用 API但用set_chunked_content_provider()text/event-stream即可实现e01-sse-server.mdsvr.Get(/events, [](const httplib::Request req, httplib::Response res) { res.set_chunked_content_provider( text/event-stream, [](size_t offset, httplib::DataSink sink) { std::string message data: hello\n\n; // \n\n 分隔一个事件 sink.write(message.data(), message.size()); std::this_thread::sleep_for(std::chrono::seconds(1)); return true; // 返回 true 则持续推送 }); });三个要点Content-Type 设为text/event-stream消息遵循data: 内容\n\n格式含多行内容时每行都要以data:开头每次sink.write()客户端立即可收到。可用req.is_connection_closed()sink.done()优雅结束推送结合 S16用: ping\n\n注释行做心跳防止代理断连。配套配方E02 事件名区分event:字段、E03 断线重连retry:字段与Last-Event-ID、E04 客户端接收用ContentReceiver解析事件流。仓库还提供独立 SSE 文档 README-sse.md 与示例 example/ssesvr.cc、example/ssecli.cc、example/ssecli-stream.cc 可对照学习。注意SSE 每连接会占用一个工作线程并发高时应将线程池设为动态伸缩如ThreadPool(8, 128)详见 S21。六、WebSocketW01–W06W01 回显服务器 / 客户端w01-websocket-echo.md服务端svr.Get(/ws, websocket_handler)通过req.ws的消息回调收发文本/二进制帧示例见 example/wsecho.cc。W02 心跳w02-websocket-ping.mdping()定时发送 Ping 帧维持连接与探活配套独立测试 test/test_websocket_heartbeat.cc。W03 关闭处理w03-websocket-close.md在 close 回调中清理资源处理对端主动关闭。W04 二进制帧w04-websocket-binary.md区分文本/二进制帧类型收发任意字节序列。W05 wss:// 的 TLSw05-websocket-tls.mdSSLServer WebSocket 路由即得 wss 服务端客户端用httplib::Client走 https 地址。W06 超时设置w06-websocket-timeouts.md配置读写超时避免僵尸连接线程安全相关验证见 test/test_websocket_thread_safety.cc综合文档见 README-websocket.md。七、如何把 Cookbook 落到代码中引入库cpp-httplib 是 header-only 库只需#include httplib.h仓库根目录 httplib.h约 1.9 万行并链接系统网络库如需 TLS 则按 T01 选择后端编译。构建示例可参考 example/Makefile 与 CMakeLists.txt。按需取配方从本文的编号映射定位问题直接打开对应文档每个配方都是可独立编译的最小示例想系统入门先读 Tour 的 01–09 章。对照示例与测试客户端/服务器综合示例见 example/server.cc、example/client.cc、example/server_and_client.cc同一进程双端通信行为验证覆盖于 test/test.ccSSE 见 README-sse.md流式传输见 README-stream.md。适用前提文中 TLS、Digest 认证、压缩等能力依赖编译期开启的对应后端OpenSSL/mbedTLS/wolfSSL、zlib/brotli未开启时相关 API 不可用或行为受限请以当前构建配置为准。赞分享后端网络【免费下载链接】cpp-httplibA C header-only HTTP/HTTPS server and client library项目地址https://gitcode.com/GitHub_Trending/cp/cpp-httplib点击查看免费下载相关推荐cpp-httplib WebSocket TLS 配置指南让 wss:// 客户端安全连接cpp httplib WebSocket TLS 配置指南让 wss:// 客户端安全连接 cpp httplib 的 ws::WebSocketClien后端网络cpp-httplib 的 wss:// WebSocket TLS 配置指南证书验证与 mTLS 客户端实战cpp httplib 的 wss:// WebSocket TLS 配置指南证书验证与 mTLS 客户端实战 cpp httplib 的 httplib::后端网络cpp-httplib WebSocket 实战用 C 实现双端 Echo 服务器与客户端cpp httplib WebSocket 实战用 C 实现双端 Echo 服务器与客户端 WebSocket 是建立在 HTTP Upgrade 之上的后端网络创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考