使用libcurl可实现跨平台C++ HTTP客户端，先安装库并配置环境，再通过curl_easy_init初始化，设置URL、回调函数等选项，用curl_easy_perform发送GET或POST请求，最后清理资源；编译时需链接libcurl库。
要用C++实现一个简单的HTTP客户端，最常用且跨平台的方式是使用 libcurl。libcurl 是一个功能强大的开源网络库，支持 HTTP、HTTPS、FTP 等多种协议，广泛用于 C/C++ 项目中进行网络请求。
1. 安装和配置 libcurl
在开始编码前，需要确保系统中已安装 libcurl：
-
Ubuntu/Debian：运行
sudo apt install libcurl4-openssl-dev -
CentOS/RHEL：运行
sudo yum install curl-devel -
macOS：使用 Homebrew 安装：
brew install curl -
Windows（推荐）：使用 vcpkg 安装：
vcpkg install curl，或下载预编译版本并配置到项目中
2. 编写基本的 HTTP GET 请求
以下是一个使用 libcurl 发起简单 HTTP GET 请求的完整示例：
#include <iostream>
#include <string>
#include <curl/curl.h>
// 回调函数：接收响应数据
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
size_t totalSize = size * nmemb;
output->append(static_cast<char*>(contents), totalSize);
return totalSize;
}
int main() {
// 初始化 curl
CURL* curl = curl_easy_init();
std::string response;
if (curl) {
// 设置请求URL
curl_easy_setopt(curl, CURLOPT_URL, "https://httpbin.org/get");
// 设置接收数据的回调函数
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
// 执行请求
CURLcode res = curl_easy_perform(curl);
if (res == CURLE_OK) {
std::cout << "响应内容:\n" << response << std::endl;
} else {
std::cerr << "请求失败: " << curl_easy_strerror(res) << std::endl;
}
// 清理资源
curl_easy_cleanup(curl);
} else {
std::cerr << "curl 初始化失败" << std::endl;
}
return 0;
}3. 发送 POST 请求并提交数据
发送表单或 JSON 数据也很简单。以下是发送 JSON 的示例：
立即学习“C++免费学习笔记（深入）”；
#include <iostream>
#include <string>
#include <curl/curl.h>
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
size_t totalSize = size * nmemb;
output->append(static_cast<char*>(contents), totalSize);
return totalSize;
}
int main() {
CURL* curl = curl_easy_init();
std::string response;
std::string postData = R"({"name": "张三", "age": 25})";
if (curl) {
// 设置 URL
curl_easy_setopt(curl, CURLOPT_URL, "https://httpbin.org/post");
// 启用 POST 方法
curl_easy_setopt(curl, CURLOPT_POST, 1L);
// 设置 POST 数据
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str());
// 设置 Content-Type 为 application/json
struct curl_slist* headers = nullptr;
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
// 设置写入回调
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
// 执行请求
CURLcode res = curl_easy_perform(curl);
if (res == CURLE_OK) {
std::cout << "POST 响应:\n" << response << std::endl;
} else {
std::cerr << "POST 请求失败: " << curl_easy_strerror(res) << std::endl;
}
// 清理
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
}
return 0;
}4. 编译与链接
编译时需要链接 libcurl 库。假设源文件名为 http_client.cpp，编译命令如下：
g++ http_client.cpp -o http_client -lcurl
如果使用 CMake，可在 CMakeLists.txt 中添加：
find_package(CURL REQUIRED)
add_executable(http_client http_client.cpp)
target_link_libraries(http_client ${CURL_LIBRARIES})
target_include_directories(http_client PRIVATE ${CURL_INCLUDE_DIRS})
5. 注意事项
- 每次使用
curl_easy_init()后记得调用curl_easy_cleanup()防止资源泄漏 - 处理 HTTPS 时，若遇到证书问题，可临时设置
CURLOPT_SSL_VERIFYPEER为 0L（仅测试用，生产环境不建议） - 回调函数必须正确返回写入的字节数，否则可能导致传输中断
- 多线程环境下，确保每个线程使用独立的 CURL handle
基本上就这些。libcurl 虽然 C 风格较重，但稳定高效，适合嵌入各种 C++ 项目中完成网络通信任务。
