libcurl简介及其编程应用

阿杰在线送代码

分类：学习笔记

发布时间 2023.12.14阅读数 666 评论数 0

本文为学习笔记，整合课程内容以及下列文章：

其中，libcurl函数库常用字段解读部分：

参考博文：原文地址
作者：冬冬他哥哥

libcurl简介

在linux下用c语言做HTTP的编程有一种方法是依赖于这个libcurlv库，以后做跨平台网络协议相关的开发，第一个要想到的就是它。

libcurl是一个跨平台的网络协议库，支持http, https, ftp等协议，libcurl同样支持：

（1）HTTPS证书授权
（2）HTTP POST, HTTP PUT, FTP 上传
（3） HTTP基本表单上传，代理，cookies,和用户认证

库下载地址：库下载
然后发送到linux开发环境中。

libcurl的使用

学会开源包使用的一般步骤

我们是希望通过学会使用libcurl库来掌握一系列类似的库的使用方法，所谓触类旁通。

windows下载完库后拖拽到ubuntu，创建一个空文件，把库拉进来。

包的解读

解压下载的库

tar xvf curl-7.71.1.tar.bz2

进入文件夹

cd curl-7.71.1

对于这种开源的包，一定要学会它的使用

先看README：

vi README

难受，看不懂
在这里插入图片描述
没关系，去看这个

docs文件夹很重要，一般是对README的补充

cd docs

不需要看太多，看类似于这个：提到的相关的API手册

vi curl.1

也很难受，真提取不到什么信息。

嵌入式开发变得简单了是因为嵌入式经过十几二十年的发展有很多人对其进行解读，写了很多文章。

重点是看INSTALL文件

还是重点来看看docs下的INSTALL文件，库一定要学会安装才能使用。

vi INSTALL

在这里插入图片描述

来读一读，大概看看INSTALL.md

vi INSTALL.md

在这里插入图片描述

可以看到./configure后面没有跟任何参数就是默认安装位置了，这里我们肯定要做配置，不配置都不知道文件安装到哪里去了

make就是编译的意思
make install就是把编译的结果拷贝到根的文件夹底下

关于帮助：
不在原本默认的路径下安装说明：
在这里插入图片描述
配置是否支持https：
回到/http/curl-7.71.1目录下，configure --help看看

./configure --help

可以看到上文所提及的安装路径配置：

在这里插入图片描述
也可以看到特别重要的交叉编译说明:

库的配置 > 编译 > 安装

（1）安装位置的更改：

配置为：$获取当前路径,编译的时候会自动生成_install文件夹，并且把编译生成的东西全部放入这个文件夹。

./configure --prefix=$PWD/_install

另外，这是针对于交叉编译的配置：编译后在树莓派上用
./configure --prefix=$PWD/_install --host=arm-linux
这样，在ubuntu中就会使用arm-gcc进行编译

（2）开始编译

make

（3）安装

make install

4）预览

进入 /_install

我们用的是头文件

cd include

进入里面的这个

cd curl

这些都是要用到的头文件
就像树莓派编译是要链接库一样

gcc a.c -lwiringPi -lpthread

用到这个库的时候，我们同样需要链接_install/lib里面的libcurl.so动态库（.a是静态库）

编程实例：访问百度主页

把_install里的内容结合一下示例代码来访问一下百度。

代码

#include <stdio.h>
#include <curl/curl.h>
 
typedef unsigned int bool;//数据类型别名用typedef
#define true 1            //宏定义用define
#define false 0
 
bool getUrl(char *filename)
{
        CURL *curl;
        CURLcode res;
        FILE *fp;
        if ((fp = fopen(filename, "w")) == NULL)  // 返回结果用文件存储
                return false;
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Accept: Agent-007");
        curl = curl_easy_init();    // 初始化
        if (curl)
        {
                //curl_easy_setopt(curl, CURLOPT_PROXY, "10.99.60.201:8080");// 代理
                curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);// 改协议头
                curl_easy_setopt(curl, CURLOPT_URL,"http://www.baidu.com");
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp); //将返回的http头输出到fp>指向的文件,即为filename文件，而传入的参数是 /tmp/get.html，即为真正保存在get.html文件中
                curl_easy_setopt(curl, CURLOPT_HEADERDATA, fp); //将返回的html主体数据输出到fp指向的文件
                res = curl_easy_perform(curl);   // 执行
                if (res != 0) {
 
                        curl_slist_free_all(headers);  //释放句柄
                        curl_easy_cleanup(curl);
                }
                fclose(fp);
                return true;
        }
}
bool postUrl(char *filename)
{
        CURL *curl;
        CURLcode res;
        FILE *fp;
        if ((fp = fopen(filename, "w")) == NULL)
                return false;
        curl = curl_easy_init();
        if (curl)
        {
                curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "/tmp/cookie.txt"); // 指定cookie文件
                curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "&logintype=uid&u=xieyan&psw=xxx86");    // 指定post内容：用户信息，尝试登陆新浪邮箱
                //curl_easy_setopt(curl, CURLOPT_PROXY, "10.99.60.201:8080");
                curl_easy_setopt(curl, CURLOPT_URL, " http://mail.sina.com.cn/cgi-bin/login.cgi ");   // 指定url
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
                res = curl_easy_perform(curl);
                curl_easy_cleanup(curl);
        }
        fclose(fp);
        return true;
}
int main(void)
{
        getUrl("/tmp/get.html");
        postUrl("/tmp/post.html");
}

为什么要有最开始的那三句代码呢？
类似于bool，true，faluse，这是C99标准才会支持，C++里有专门的bool类型,用来表示真或假。但是在C语言里没有这样的类型，为了修改方便直接这样替换。

编译注意：

链接库和头文件再编译，同时注意指明他们的路径

gcc getAndPost.c -I ./curl-7.71.1/_install/include/ -L ./curl-7.71.1/_install/lib/ -lcurl

注意了，动态库静态库的链接用-L，而头文件用-I

错误排查：

（1）如果只是使用-L是默认去usr/lib下去找的,会提示找不到cannot find -lcurl

（2）如果编译报错一堆函数不认识，函数是存在库里面的，说明没有链接库

usr/bin/ld: getAndPost.c:(.text+0x1a2): undefined reference to `curl_easy_init'
/usr/bin/ld: getAndPost.c:(.text+0x1d2): undefined reference to `curl_easy_setopt'
/usr/bin/ld: getAndPost.c:(.text+0x1f6): undefined reference to `curl_easy_setopt'
/usr/bin/ld: getAndPost.c:(.text+0x217): undefined reference to `curl_easy_setopt'
/usr/bin/ld: getAndPost.c:(.text+0x238): undefined reference to `curl_easy_setopt'
/usr/bin/ld: getAndPost.c:(.text+0x244): undefined reference to `curl_easy_perform'

（3）提示找不到头文件#include ，说明没有指明头文件的路径

可以看到已经生成了可执行文件./a.out

直接运行这个./a.out是会报错的

error while loading shared libraries: libcurl.so.4:cannot open shared object file:no such file or directory

原因是没有添加环境变量，忘记怎么添加咋办？面向百度，export lib path

export LD_LIBRARY_PATH=./curl-7.71.1/_install/lib/

成功运行后，可以看到vi /tmp/get.html中已经有了百度官网的代码。（仅贴出部分）

vi /tmp/get.html

在这里插入图片描述这跟我们平常去访问百度是一样的,只是用了前端css去排版的比较好看罢了，当你右键查看页面源码就知道了。

而vi /tmp/port.html里面不会有东西，因为访问失败了：新浪的用户和密码不匹配。

libcurl函数库常用字段解读

一、调用curl_global_init()：初始化libcurl

函数只能用一次。(其实在调用curl_global_cleanup 函数后仍然可再用)

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

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

参数：flags

CURL_GLOBAL_ALL               //初始化所有的可能的调用。(最常用)
CURL_GLOBAL_SSL              //初始化支持 安全套接字层。
CURL_GLOBAL_WIN32            //初始化win32套接字库。
CURL_GLOBAL_NOTHING         //没有额外的初始化。

二、调用curl_easy_init()：得到 easy interface型指针,拿到句柄

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

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

后续所有的操作都是对这个指针进行设置，把这种类型的指针就叫做句柄，实例：

其实socket服务器再socket函数后生成的fd，后续的bind，accept等操作也是基于这个fd，也可以理解为句柄

三、调用curl_easy_setopt(CURL *handle, CURLoption option, parameter)：设置传输选项

根据设置的传输选项，实现回调函数以完成用户特定任务（设置与操作句柄）

这个函数最重要了.几乎所有的curl 程序都要频繁的使用它.它告诉curl库.程序将有如何的行为. 比如要查看一个网页的html代码等.(这个函数有些像ioctl函数)

参数:
（1）CURL类型的指针
（2）CURLoption类型的选项.(都在curl.h库里有定义,man 也可以查看到)
（3）parameter 既可以是个函数的指针,也可以是某个对象的指针,也可以是个long型的变量，取决于第二个参数。

CURLoption常用的选项:
（1）CURLOPT_URL:设置访问URL,就是设置访问的网址
（2）CURLOPT_WRITEFUNCTION，CURLOPT_WRITEDATA
回调函数：网页有数据请求回来的时候，如何去处理这些数据。（做人脸识别，肯定要获得人脸识别的结果）

设置的回调函数格式要求为：
size_t function( void *ptr, size_t size, size_t nmemb, void *stream);

函数将在libcurl接收到数据后被调用，因此函数多做数据保存的功能，如处理下载文件。

CURLOPT_WRITEFUNCTION使用举例
①陈老师的车牌识别车牌识别

int BufferWriterFunc(char* data,size_t size,size_t nmemb,char *buffer)
{
	strcpy(bufferData,data);//把返回的data数据放在本地的bufferData数组中
	return size*nmemb;
}
 
//配置如下：
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION,BufferWriterFunc);

②修改上面访问百度的代码

size_t readData(void *ptr, size_t size, size_t nmemb, void *stream)
{
	char buf[1024] = {'\0'};
	strncpy(buf,ptr,1024);
	printf("===========get data ===========\n");
	printf("%s\n",buf);
}
 
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION,readData);

CURLOPT_WRITEDATA使用举例

也可以通过 CURLOPT_WRITEDATA属性给默认回调函数传递一个已经打开的文件指针，用于将数据输出到文件里。

正如上面访问百度的例子：

FILE *fp;
if ((fp = fopen(filename, "w")) == NULL)//提前打开了一个文件流
        return false;
 
curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);//请求回来的所有数据都放到文件中

（3）CURLOPT_POSTFIELDS
在post请求中：以&拼接字符串的形式把参数链接起来

curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "&logintype=uid&u=xieyan&psw=xxx86");    // 指定post内容：用户信息，尝试登陆新浪邮箱

下片文章提到的翔云人工智能平台OCRkey和密码就要放在这里传输。
四、调用curl_easy_perform()：完成传输任务
在初始化CURL类型的指针 以及curl_easy_setopt完成后调用. 就像字面的意思所说perform就像是个舞台.让我们设置的option 运作起来。
五、调用curl_easy_cleanup()：释放内存
结束libcurl使用的时候，用来对curl_global_init做的工作清理。类似于close的函数。
该死的a库不好用

./a.out: /usr/lib/arm-linux-gnueabihf/libssl.so.1.1: version `OPENSSL_1_1_1' not found (required by ./curl-7.71.1/_install/lib/libcurl.so.4)

linux 嵌入式 C语言 libcurl

转载原出处：

打赏 0

上一篇：51单片机中 bit和sbit区别

下一篇：java的面向对象基础（1） —— 封装

libcurl简介及其编程应用

阿杰在线送代码

目录

libcurl简介

libcurl的使用

学会开源包使用的一般步骤

包的解读

重点是看INSTALL文件

库的 配置 > 编译 > 安装

编程实例：访问百度主页

libcurl函数库常用字段解读

为你推荐

Ros_PX4_Mavros从零入门--哪些坑

github在qtcreator中的使用

ROS答疑（一）——如何进行时间同步操作

TensorFlow处理数据常用套路

4.MySQL数据导入、导出

PointCloud 点云处理方法总结(代码案例版)

评论（0）

关于作者

阿杰在线送代码

39

0

400

2

基于STM32智能小车-＞超声波篇

STM32_基础入门（九）_串口通讯详解

精选STM32_基础入门（五）_SysTick定时器_终于读懂系列

相关推荐

机器人操作系统ROS从入门到放弃(六)：使用roslaunch

VScode 关闭新建文件的语言选择提示后如何再开启

【STM32】输入捕获实验代码详解

精选selenium 安装与 chromedriver安装

CaDDN代码调试

maya节点绕轴旋转

热门泡泡

30积分 失眠，聊聊自己搞ROS的心得体会吧

ros学习路线

30积分 TF_REPEATED_DATA ignoring data错误

各位大佬，有什么ROS定位算法推荐吗

5积分 想买能用ROS2的开发套件。或者开发板

5积分 ros中启动gazebo时报错

给作者打赏

忘记密码

修改头像

添加你感兴趣的标签

举报类型（必选）

举报详情（选填）

库的配置 > 编译 > 安装

30积分失眠，聊聊自己搞ROS的心得体会吧

5积分想买能用ROS2的开发套件。或者开发板