尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

cpp-httplib:一个头文件十分钟跑通 C++ HTTP 服务

cpp-httplib:一个头文件十分钟跑通 C++ HTTP 服务 cpp-httplib一个头文件十分钟跑通 C HTTP 服务【免费下载链接】cpp-httplibA C header-only HTTP/HTTPS server and client library项目地址: https://gitcode.com/GitHub_Trending/cp/cpp-httplib你需要 C 项目能对外提供 HTTP 服务cpp-httplib 就是最短路径把一个 httplib.h 丢进项目目录写下svr.Get(/, ...)两分钟后浏览器里已经返回了 Hello World。这是一个 C11 单文件头文件库服务端和客户端都装在这一个 .h 里不用 CMake、不用包管理器、不用编译第三方依赖。它撑得起的场景比 Hello World 大得多。下图来自仓库内置的教程从 llama.cpp 的 REST API到 SSE token 流式输出再到浏览器界面和桌面应用全部基于这同一个头文件搭出来。一个头文件能干什么拆成四块看协议覆盖—— HTTP/1.1 服务端和客户端同库提供chunked 传输、WebSocket、SSE、Stream API 都有现成实现。注意它只做 HTTP/1.1没有 HTTP/2/3。TLS 后端—— 一套抽象层接三个后端用编译开关切换后端编译开关要求OpenSSLCPPHTTPLIB_OPENSSL_SUPPORT3.0 及以上链接 libssl/libcryptoMbed TLSCPPHTTPLIB_MBEDTLS_SUPPORT2.x–4.x 均可wolfSSLCPPHTTPLIB_WOLFSSL_SUPPORT5.x需--enable-opensslall部署成本—— 整个库就是一个 .h拷进工程即可编译C11 起就能用GCC、Clang、MSVC 都通。example 目录 里有一堆能直接编译的样例server、client、websocket、SSE 各有独立文件。扩展点—— 路由支持路径参数/users/:id和正则两种写法CustomRoute能注册 WebDAV、UPnP 这类非标准方法pre/post routing 钩子可以挂认证和日志逻辑访问日志、错误日志、gzip 压缩、mTLS 双向认证都是内置项。三步跑通你的第一个 HTTP 服务拿头文件。克隆仓库根目录的httplib.h就是你需要的全部内容git clone https://gitcode.com/GitHub_Trending/cp/cpp-httplib写 server.cpp。核心不到 10 行#include httplib.h int main() { httplib::Server svr; svr.Get(/, [](const httplib::Request, httplib::Response res) { res.set_content(Hello, World!, text/plain); }); svr.listen(0.0.0.0, 8080); }编译运行。Linux/macOS 必须带-pthread库内部用线程池Windows MSVC 用/EHsc开启异常支持g -stdc11 -pthread -o server server.cpp ./server curl http://localhost:8080/浏览器打开http://localhost:8080看到响应即算跑通。macOS/Windows 的编译器环境准备见官方入门文档。三个已被验证的落地场景本地 LLM 推理服务封装。官方教程 llm-app 演示了完整路线把 llama.cpp 包成 REST API 返回 JSON用 SSE 做 token 级流式输出加一层 Web 界面最后配合 webview 打成单文件桌面应用。C 推理库的通病是模型能跑、界面没人写Electron 打包太重这套方案从头到尾只用纯 C。单板设备的 Web 管理页。set_mount_point(/web, ./ui)挂上 HTML 目录再注册/api/status、/api/restart两个端点设备配置界面就完成了。不用额外起进程、不用引入 web 框架一个二进制管完页面和接口适合空间紧张的嵌入式部署。微服务间的内网调用。客户端侧就是SSLClient指向内网地址配 mTLS 还能在服务间做双向认证httplib::SSLClient cli(order-service, 8443, ./client-cert.pem, ./client-key.pem); auto res cli.Get(/orders?userId123); if (res) { std::cout res-body std::endl; }哪里不合适先说清楚阻塞式 I/O 模型。README 在开头就声明库使用阻塞 socket I/O连接由线程池承载。几百 QPS 的内部服务足够用要承载上万并发长连接请选非阻塞模型别硬上。只有 HTTP/1.1。上游是需要多路复用的高并发网关时它不在能力范围内。32 位平台不支持。能编译但未做安全审查维护者明确不处理仅影响 32 位的漏洞报告。编译时间是单文件模式的代价。这个 .h 超过一万行每个 include 它的编译单元都要完整解析大工程里控制一下包含范围别到处#include httplib.h。静态文件服务方法不是线程安全的请求处理期间不要运行时再调set_mount_point。两个省下通宵的细节TLS 编译开关必须写在 include 之前。漏掉#define CPPHTTPLIB_OPENSSL_SUPPORT引用SSLClient时才会报错定位起来很浪费时间链接阶段还要补上-lssl -lcryptog -stdc17 -pthread -o client client.cpp -lssl -lcrypto客户端失败先分层看错误。res.error()给出错误类别连接失败、SSL 连接、证书加载、主机名校验各有独立枚举值SSL 类错误再进一步读ssl_error()和ssl_backend_error()就能区分握手挂了还是主机名不匹配而不是对着一个false干瞪眼。把这个文件拷走cpp-httplib 用一点性能上限换来了近乎零的接入摩擦单文件、C11、三平台可编译。原型验证、嵌入式管理页、内网服务间调用这三类场景选它不会错。现在打开终端执行git clone https://gitcode.com/GitHub_Trending/cp/cpp-httplib把根目录的httplib.h拷进你的工程按上面三步十分钟内你的第一个 C HTTP 服务就能访问了。【免费下载链接】cpp-httplibA C header-only HTTP/HTTPS server and client library项目地址: https://gitcode.com/GitHub_Trending/cp/cpp-httplib创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表