【亲测免费】 C++ Requests (cpr) 开源项目教程

2026-01-23 04:55:03作者：胡唯隽

项目地址：https://gitcode.com/gh_mirrors/cpr/cpr

1. 项目介绍

C++ Requests（简称cpr）是一个基于libcurl的简单封装库，灵感来源于优秀的Python Requests项目。它旨在通过C++17（或C++11，适用于cpr < 1.10.0版本）的语言特性，简化网络请求的编写过程，提供更直观和易用的接口。

主要特点

支持自定义请求头
支持URL编码的参数和POST值
支持多部分表单POST上传
支持文件POST上传
支持基本认证、Bearer认证、Digest认证、NTLM认证
支持连接和请求超时设置
支持异步请求
支持Cookie和代理
提供回调接口
支持PUT、DELETE、HEAD、OPTIONS、PATCH方法
线程安全访问libCurl
支持OpenSSL和WinSSL的HTTPS请求

2. 项目快速启动

环境要求

C++17兼容的编译器（如Clang或GCC）
若使用HTTPS请求，需要OpenSSL及其开发库
若使用系统自带的curl，需确保版本 >= 7.64.0

安装步骤

使用CMake FetchContent

在你的CMake项目中添加以下内容：

include(FetchContent)
FetchContent_Declare(
    cpr
    GIT_REPOSITORY https://github.com/libcpr/cpr.git
    GIT_TAG 3b15fa82ea74739b574d705fea44959b58142eb8
)
FetchContent_MakeAvailable(cpr)

在你的目标链接中添加：

target_link_libraries(your_target_name PRIVATE cpr::cpr)

使用CMake find_package

克隆并构建cpr：

git clone https://github.com/libcpr/cpr.git
cd cpr && mkdir build && cd build
cmake -DCPR_USE_SYSTEM_CURL=ON
cmake --build . --parallel
sudo cmake --install .

在你的CMakeLists.txt中添加：

find_package(cpr REQUIRED)
add_executable(your_target_name your_target_name.cpp)
target_link_libraries(your_target_name PRIVATE cpr::cpr)

示例代码

以下是一个简单的GET请求示例：

#include <cpr/cpr.h>

int main(int argc, char** argv) {
    cpr::Response r = cpr::Get(
        cpr::Url{"https://api.github.com/repos/whoshuu/cpr/contributors"},
        cpr::Authentication{"user", "pass", cpr::AuthMode::BASIC},
        cpr::Parameters{{"anon", "true"}, {"key", "value"}}
    );
    std::cout << "Status Code: " << r.status_code << std::endl;
    std::cout << "Content-Type: " << r.header["content-type"] << std::endl;
    std::cout << "Text: " << r.text << std::endl;
    return 0;
}

3. 应用案例和最佳实践

应用案例

网络爬虫

使用cpr可以轻松实现网络爬虫，抓取网页内容进行分析和处理。

API客户端

构建API客户端，与RESTful服务进行交互，获取或提交数据。

数据上传

通过cpr的文件上传功能，实现文件的上传操作。

最佳实践

异常处理：确保对网络请求的异常情况进行处理，如超时、连接失败等。
资源管理：合理管理网络连接和响应资源，避免内存泄漏。
安全性：使用HTTPS协议进行数据传输，确保数据的安全性。
代码复用：封装常用的网络请求功能，提高代码复用性。

4. 典型生态项目

libcurl

cpr的基础库，提供强大的网络传输功能。

OpenSSL

用于实现HTTPS请求的加密库。

CMake

用于构建和管理cpr项目的构建系统。

vcpkg

用于管理和安装cpr的依赖管理工具。

Conan

另一种用于管理和安装cpr的依赖管理工具。

通过以上模块的介绍，希望你能快速上手并有效使用C++ Requests (cpr) 项目。更多详细文档和示例请参考官方GitHub仓库。

cpr