1.简介
libcurl 是一个功能强大的库，支持多种协议，用于数据传输。它广泛应用于实现网络操作，如HTTP、HTTPS、FTP、FTPS、SCP、SFTP等。libcurl 提供了丰富的 API，可以在多种编程语言中使用。
libcurl 主要特点
- 支持多种协议：包括 HTTP, HTTPS, FTP, FTPS, SCP, SFTP,等。
- 多平台支持：可在多种操作系统上使用，如 Windows、Linux、Mac OS X 等。
- 线程安全：在多线程程序中使用时，保证数据的安全性。
- 异步操作：支持非阻塞的方式执行网络操作，提高程序的效率。
- 自动重连和恢复传输：支持断点续传等功能。
2.常用接口介绍
- curl_global_init(long flags)
用途：初始化 libcurl 库，这是在使用任何 libcurl 功能之前必须调用的。
参数：接受一个标志，通常是 CURL_GLOBAL_ALL，用于初始化所有内部数据结构。
返回值：CURLE_OK 表示成功，其他值表示错误。
- curl_easy_init(void)
用途：创建一个易用的 curl 句柄，用于后续的 curl 操作。
返回值：返回一个 CURL* 句柄，如果失败则返回 NULL。
- curl_easy_setopt(CURL *curl, CURLoption option, ...)
用途：设置 curl 句柄的参数。这个函数用于定义库的行为，如 URL、超时、回调函数等。
参数：CURL *curl，CURLoption option，和相应的值。
返回值：CURLE_OK 表示成功，其他值表示错误。
- curl_easy_perform(CURL *curl)
用途：执行请求操作。
参数：配置好的 CURL *handle。
返回值：CURLE_OK 表示成功，其他值表示传输过程中遇到的错误。
- curl_easy_cleanup(CURL *curl)
用途：结束一个 curl 会话，释放资源。
参数：CURL *handle。
- curl_global_cleanup()
用途：在程序结束时调用，清理由 curl_global_init() 初始化的资源。
3.环境搭建
下载地址：https://github.com/curl/curl
下载完成，进行解压，然后使用cmake编译。
configure->Generate->Open Project
生成库如下图所示：
拷贝如下文件和lib文件到我们的demo工程中。
源码目录的下的curl目录，以及lib、dll库。
配置visual studio环境，请看Jsoncpp介绍。如何配置include、lib目录。
4.示例
下面是一个使用libcurl的简单示例，它发送一个HTTP GET请求到指定的URL，并将响应内容打印到标准输出。
cpp
#include <iostream>
#include <curl/curl.h>
#include <string>
using namespace std;
// 回调函数，用于处理接收到的数据
size_t writeCallback(void* contents, size_t size, size_t nmemb, std::string* userp)
{
userp->append((char*)contents, size * nmemb);
return size * nmemb;
}
int main()
{
CURL* curl;
CURLcode res;
std::string readBuffer;
curl_global_init(CURL_GLOBAL_DEFAULT);
curl = curl_easy_init();
if (curl)
{
curl_easy_setopt(curl, CURLOPT_URL, "http://www.baidu.com");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writeCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer);
res = curl_easy_perform(curl);
if (res != CURLE_OK)
{
std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
}
else
{
std::cout << "Output: " << readBuffer << std::endl;
}
curl_easy_cleanup(curl);
}
curl_global_cleanup();
return 0;
}FTP下载示例：
cpp
int main(void)
{
CURL *curl;
CURLcode res;
curl_global_init(CURL_GLOBAL_ALL);
curl = curl_easy_init();
if (curl)
{
// 设置FTP服务器的URL和要下载的文件名
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/file.txt");
// 设置FTP用户名和密码
curl_easy_setopt(curl, CURLOPT_USERPWD, "username:password");
// 设置写数据回调函数，将数据写入文件
FILE *fp = fopen("output.txt", "wb");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, NULL);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
// 执行FTP下载
res = curl_easy_perform(curl);
// 检查是否有错误发生
if (res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
// 关闭文件
fclose(fp);
// 清理cURL资源
curl_easy_cleanup(curl);
}
curl_global_cleanup();
return 0;
}