libcurl网络协议库使用Demo

mickey0380

于 2024-10-07 00:15:00 发布

阅读量503

点赞数 20

分类专栏：系统调用文章标签： http restful libcurl 网络通信库

本文链接：https://blog.csdn.net/mickey2007/article/details/142281730

版权

系统调用专栏收录该内容

14 篇文章 0 订阅

订阅专栏

4.1 全局初始化函数 curl_global_init

4.2 全局释放函数 curl_global_cleanup

4.3 libcurl库版本 curl_version

4.4 开启会话 curl_easy_init

4.5 结束会话 curl_easy_cleanup

4.6 设置传输选项 curl_easy_setopt

4.7 执行传输任务 curl_easy_perform

1 libcurl简介

libcurl是一个跨平台的网络协议库，支持http, https, ftp, gopher, telnet, dict, file, 和ldap等协议。libcurl同样支持HTTPS证书授权，HTTP POST, HTTP PUT, FTP 上传, HTTP基本表单上传，代理，cookies,和用户认证。

官网：https://curl.haxx.se/

2 libcurl编译

Windows平台libcurl库的下载地址：curl for Windows

注意：下载的Windows库，只包含头文件和dll库，缺少lib文件。

可用VS编译器自带工具命令行根据def文件和dll文件生成lib文件

以“管理员身份”运行cmd，进行VS的安装路径，把def文件和dll文件放到VC\bin目录下，然后执行：

lib /machine:x64 /def:libcurl-x64.def         //生产64位lib文件libcurl-x64.lib
lib /machine:x86 /def:libcurl.def             //生产32位lib文件libcurl.lib

3 使用步骤

调用curl_global_init()初始化libcurl
调用curl_easy_init()函数得到CURL指针
根据curl_easy_setopt()设置传输选项，设置回调函数以完成用户特定任务
调用curl_easy_perform()函数执行传输任务
调用curl_easy_cleanup()释放内存
调用curl_global_cleanup()析构libcurl

在整个过程中设置curl_easy_setopt()参数是最关键的，几乎所有的libcurl程序都要使用它。

在基于libcurl的程序里，主要采用callback function（回调函数）的形式完成传输任务，用户在启动传输前设置好各类参数和回调函数，当满足条件时libcurl将调用用户的回调函数实现特定功能。

4 函数说明

4.1 全局初始化函数 curl_global_init

/*
    功能：全局初始化
    参数：flags - [in]   CURL_GLOBAL_ALL       //初始化所有的可能的调用。
                        CURL_GLOBAL_SSL       //初始化支持 安全套接字层。
                        CURL_GLOBAL_WIN32     //初始化win32套接字库。
                        CURL_GLOBAL_NOTHING   //没有额外的初始化。
    返回：0-成功，其他-失败
*/
CURLcode curl_global_init(long flags);

这个函数只能用一次。如果这个函数在curl_easy_init函数调用时还没调用，它将由libcurl库自动调用，所以多线程下最好主动调用该函数以防止在线程中curl_easy_init时多次调用。

注意：虽然libcurl是线程安全的，但curl_global_init是不能保证线程安全的，所以不要在每个线程中都调用curl_global_init，应该将该函数的调用放在主线程中。

4.2 全局释放函数 curl_global_cleanup

/*
    功能：全局释放
    参数：
    返回：
*/
void curl_global_cleanup(void);

在结束libcurl使用的时候，用来对curl_global_init做的工作清理。类似于close的函数。

注意：虽然libcurl是线程安全的，但curl_global_cleanup是不能保证线程安全的，所以不要在每个线程中都调用curl_global_init，应该将该函数的调用放在主线程中。

4.3 libcurl库版本 curl_version

 /*
    功能：libcurl库版本
    参数：
    返回：libcurl库版本
*/
char *curl_version(void);

4.4 开启会话 curl_easy_init

 /*
    功能：初始化CURL指针
    参数：
    返回：CURL指针
*/
CURL *curl_easy_init(void);

curl_easy_init用来初始化一个CURL的指针(有些像返回FILE类型的指针一样)，相应的在调用结束时要用curl_easy_cleanup函数清理。

一般curl_easy_init意味着一个会话的开始。它会返回一个easy_handle(CURL*对象)，一般都用在easy系列的函数中。