在C++开发中，实现HTTP客户端是很多网络相关功能的基础需求，libcurl作为成熟的网络传输库，能大幅降低开发难度，支持多种协议，其中HTTP请求的实现尤为便捷。
环境准备
首先需要在开发环境中安装libcurl库，不同系统的安装方式有所区别：
- Ubuntu/Debian系统：执行
sudo apt-get install libcurl4-openssl-dev命令安装 - CentOS系统：执行
sudo yum install libcurl-devel命令安装 - Windows系统：可以从libcurl官方站点下载编译好的库文件，配置到项目的包含目录和库目录中
libcurl核心使用流程
使用libcurl发起HTTP请求通常遵循以下固定步骤：
- 调用
curl_global_init初始化全局环境 - 调用
curl_easy_init创建请求句柄 - 设置请求相关参数，比如请求URL、请求方法、请求头、超时时间等
- 调用
curl_easy_perform执行请求 - 处理请求响应数据
- 调用
curl_easy_cleanup释放请求句柄 - 调用
curl_global_cleanup清理全局环境
实现GET请求示例
下面是一个简单的GET请求实现，用于获取指定URL的响应内容：
#include <iostream>
#include <curl/curl.h>
// 回调函数，用于处理响应数据
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {
size_t totalSize = size * nmemb;
userp->append((char*)contents, totalSize);
return totalSize;
}
int main() {
// 初始化全局环境
curl_global_init(CURL_GLOBAL_DEFAULT);
// 创建请求句柄
CURL* curl = curl_easy_init();
if (curl) {
// 设置请求URL
curl_easy_setopt(curl, CURLOPT_URL, "http://ipipp.com/api/test");
// 设置接收响应数据的回调函数
std::string response;
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
// 设置超时时间为5秒
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 5L);
// 执行请求
CURLcode res = curl_easy_perform(curl);
if (res != CURLE_OK) {
std::cerr << "请求失败: " << curl_easy_strerror(res) << std::endl;
} else {
// 获取HTTP响应状态码
long httpCode = 0;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &httpCode);
std::cout << "响应状态码: " << httpCode << std::endl;
std::cout << "响应内容: " << response << std::endl;
}
// 释放请求句柄
curl_easy_cleanup(curl);
}
// 清理全局环境
curl_global_cleanup();
return 0;
}
实现POST请求示例
POST请求需要额外设置请求方法和请求体数据，下面是发送表单类型POST请求的示例：
#include <iostream>
#include <curl/curl.h>
#include <string>
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {
size_t totalSize = size * nmemb;
userp->append((char*)contents, totalSize);
return totalSize;
}
int main() {
curl_global_init(CURL_GLOBAL_DEFAULT);
CURL* curl = curl_easy_init();
if (curl) {
// 设置请求URL
curl_easy_setopt(curl, CURLOPT_URL, "http://ipipp.com/api/submit");
// 设置POST请求方法
curl_easy_setopt(curl, CURLOPT_POST, 1L);
// 设置POST请求体，这里是表单格式数据
std::string postData = "username=test&password=123456";
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str());
// 设置请求头，指定内容类型
struct curl_slist* headers = nullptr;
headers = curl_slist_append(headers, "Content-Type: application/x-www-form-urlencoded");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
// 设置响应处理回调
std::string response;
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::cerr << "请求失败: " << curl_easy_strerror(res) << std::endl;
} else {
long httpCode = 0;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &httpCode);
std::cout << "响应状态码: " << httpCode << std::endl;
std::cout << "响应内容: " << response << std::endl;
}
// 释放请求头和句柄
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
}
curl_global_cleanup();
return 0;
}
常见问题说明
在实际使用中可能会遇到一些常见问题：
- 如果请求返回超时错误，可以检查网络连通性，或者适当调大
CURLOPT_TIMEOUT参数的值 - 如果需要处理HTTPS请求，libcurl默认支持SSL，不需要额外配置，只要系统中有对应的CA证书即可
- 如果需要设置自定义请求头，使用
curl_slist_append添加头信息后，通过CURLOPT_HTTPHEADER设置即可 - 请求完成后一定要释放句柄和全局环境，避免内存泄漏