网络库-libcurl介绍

news2025/1/21 15:46:19

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，并将响应内容打印到标准输出。

#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下载示例：

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;
}