C++ 用libcurl库进行http通讯网络编程

最新推荐文章于 2024-07-30 09:03:28 发布
最新推荐文章于 2024-07-30 09:03:28 发布
阅读量620 收藏
点赞数
分类专栏： 网络编程 文章标签： c++ libcurl http 网络编程
一 、LibCurl基本编程框架

libcurl是一个跨平台的网络协议库，支持http, https, ftp, gopher, telnet, dict, file, 和ldap 协议。libcurl同样支持HTTPS证书授权，HTTP POST, HTTP PUT, FTP 上传, HTTP基本表单上传，代理，cookies,和用户认证。想要知道更多关于libcurl的介绍，可以到官网 http://curl.haxx.se/上去了解，在这里不再详述。

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

  1. 调用curl_global_init()初始化libcurl
  2. 调用curl_easy_init()函数得到 easy interface型指针
  3. 调用curl_easy_setopt()设置传输选项
  4. 根据curl_easy_setopt()设置的传输选项，实现回调函数以完成用户特定任务
  5. 调用curl_easy_perform()函数完成传输任务
  6. 调用curl_easy_cleanup()释放内存
  7. 调用curl_global_cleanup()释放curl_global_init申请的资源

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

二、一些基本的函数
  1. CURLcode curl_global_init(long flags);
    描述：
    这个函数只能用一次。(其实在调用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 //没有额外的初始化。

  1. void curl_global_cleanup(void);
    描述：在结束libcurl使用的时候，用来对curl_global_init做的工作清理。类似于close的函数。
    注意：虽然libcurl是线程安全的，但curl_global_cleanup是不能保证线程安全的，所以不要在每个线程中都调用curl_global_init，应该将该函数的调用放在主线程中。

  2. char *curl_version( );
    描述: 打印当前libcurl库的版本。

  3. CURL curl_easy_init( );
    描述:
    curl_easy_init用来初始化一个CURL的指针(有些像返回FILE类型的指针一样). 相应的在调用结束时要用curl_easy_cleanup函数清理.
    一般curl_easy_init意味着一个会话的开始. 它会返回一个easy_handle(CURL    对象), 一般都用在easy系列的函数中.

  4. void curl_easy_cleanup(CURL *handle);
    描述:
    这个调用用来结束一个会话.与curl_easy_init配合着用.
    参数:
    CURL类型的指针.

  5. CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);
    描述: 这个函数最重要了.几乎所有的curl 程序都要频繁的使用它.它告诉curl库.程序将有如何的行为. 比如要查看一个网页的html代码等.(这个函数有些像ioctl函数)
    参数:

  • CURL类型的指针
  • 各种CURLoption类型的选项.(都在curl.h库里有定义,man 也可以查看到)
  • parameter 这个参数 既可以是个函数的指针,也可以是某个对象的指针,也可以是个long型的变量.它用什么这取决于第二个参数.
    CURLoption 这个参数的取值很多.具体的可以查看man手册.
  1. CURLcode curl_easy_perform(CURL *handle);
    描述:这个函数在初始化CURL类型的指针 以及curl_easy_setopt完成后调用. 就像字面的意思所说perform就像是个舞台.让我们设置的option 运作起来.
    参数:
    CURL类型的指针.
三、curl_easy_setopt函数部分选项介绍

本节主要介绍curl_easy_setopt中跟http相关的参数。该函数是curl中非常重要的函数，curl所有设置都是在该函数中完成的，该函数的设置选项众多，注意本节的阐述的只是部分常见选项。

  1. CURLOPT_URL
    设置访问URL

  2. CURLOPT_WRITEFUNCTION，CURLOPT_WRITEDATA
    CURLOPT_WRITEFUNCTION 回调函数原型为：
    size_t function(void *ptr, size_t size, size_t nmemb, void *stream)
    函数将在libcurl接收到数据后被调用，因此函数多做数据保存的功能，如处理下载文件。
    CURLOPT_WRITEDATA 用于表明CURLOPT_WRITEFUNCTION函数中的stream指针的来源。
    如果你没有通过CURLOPT_WRITEFUNCTION属性给easy handle设置回调函数，libcurl会提供一个默认的回调函数，它只是简单的将接收到的数据打印到标准输出。
    你也可以通过 CURLOPT_WRITEDATA属性给默认回调函数传递一个已经打开的文件指针，用于将数据输出到文件里。

  3. CURLOPT_HEADERFUNCTION，CURLOPT_HEADERDATA
    CURLOPT_HEADERFUNCTION 回调函数原型为
    size_t function( void *ptr, size_t size,size_t nmemb, void *stream);
    libcurl一旦接收到http 头部数据后将调用该函数。CURLOPT_WRITEDATA 传递指针给libcurl，该指针表明CURLOPT_HEADERFUNCTION 函数的stream指针的来源。

  4. CURLOPT_READFUNCTION CURLOPT_READDATA
    libCurl需要读取数据传递给远程主机时将调用CURLOPT_READFUNCTION指定的函数，函数原型是：
    size_t function(void *ptr, size_t size, size_t nmemb,void *stream).
    CURLOPT_READDATA 表明CURLOPT_READFUNCTION函数原型中的stream指针来源。

  5. CURLOPT_NOPROGRESS，CURLOPT_PROGRESSFUNCTION，CURLOPT_PROGRESSDATA
    跟数据传输进度相关的参数。CURLOPT_PROGRESSFUNCTION 指定的函数正常情况下每秒被libcurl调用一次，为了使CURLOPT_PROGRESSFUNCTION被调用，CURLOPT_NOPROGRESS必须被设置为false，CURLOPT_PROGRESSDATA指定的参数将作为CURLOPT_PROGRESSFUNCTION指定函数的第一个参数

  6. CURLOPT_TIMEOUT，CURLOPT_CONNECTIONTIMEOUT:
    CURLOPT_TIMEOUT 由于设置传输时间，CURLOPT_CONNECTIONTIMEOUT 设置连接等待时间

  7. CURLOPT_FOLLOWLOCATION
    设置重定位URL

  8. CURLOPT_RANGE: CURLOPT_RESUME_FROM:
    断点续传相关设置。CURLOPT_RANGE 指定char *参数传递给libcurl，用于指明http域的RANGE头域，例如：
    表示头500个字节：bytes=0-499
    表示第二个500字节：bytes=500-999
    表示最后500个字节：bytes=-500
    表示500字节以后的范围：bytes=500-
    第一个和最后一个字节：bytes=0-0,-1
    同时指定几个范围：bytes=500-600,601-999
    CURLOPT_RESUME_FROM 传递一个long参数给libcurl，指定你希望开始传递的 偏移量。

四、curl_easy_perform 函数说明

该函数是完成curl_easy_setopt指定的所有选项，本节重点介绍curl_easy_perform的返回值。返回0意味一切ok，非0代表错误发生。主要错误码说明：

  1. CURLE_OK
    任务完成一切都好
  2. CURLE_UNSUPPORTED_PROTOCOL
    不支持的协议，由URL的头部指定
  3. CURLE_COULDNT_CONNECT
    不能连接到remote 主机或者代理
  4. CURLE_REMOTE_ACCESS_DENIED
    访问被拒绝
  5. CURLE_HTTP_RETURNED_ERROR
    Http返回错误
  6. CURLE_READ_ERROR
    读本地文件错误
    要获取详细的错误描述字符串，可以通过const char *curl_easy_strerror(CURLcode errornum ) 这个函数取得
五、libcurl使用的HTTP消息头

当使用libcurl发送http请求时，它会自动添加一些http头。我们可以通过CURLOPT_HTTPHEADER属性手动替换、添加或删除相应 的HTTP消息头。

  • Host
    http1.1（大部分http1.0)版本都要求客户端请求提供这个信息头。
  • Pragma
    “no-cache”。表示不要缓冲数据。
  • Accept
    “/”。表示允许接收任何类型的数据。
  • Expect
    以POST的方式向HTTP服务器提交请求时，libcurl会设置该消息头为"100-continue"，它要求服务器在正式处理该请求之前，返回一 个"OK"消息。如果POST的数据很小，libcurl可能不会设置该消息头。

自定义选项

当前越来越多的协议都构建在HTTP协议之上（如：soap），这主要归功于HTTP的可靠性，以及被广泛使用的代理支持（可以穿透大部分防火墙）。 这些协议的使用方式与传统HTTP可能有很大的不同。对此，libcurl作了很好的支持。

修改消息头

HTTP协议提供了消息头，请求消息头用于告诉服务器如何处理请求；响应消息头则告诉浏览器如何处理接收到的数据。在libcurl中，你可以自由的添加 这些消息头：

```
 /* init to NULL is important */
struct curl_slist *headers=NULL;
headers = curl_slist_append(headers, "Hey-server-hey: how are you?");
headers = curl_slist_append(headers, "X-silly-content: yes");
/* pass our list of custom made headers */
curl_easy_setopt(easyhandle, CURLOPT_HTTPHEADER, headers);
curl_easy_perform(easyhandle); /* transfer http */
curl_slist_free_all(headers); /* free the header list */
```
  • 对于已经存在的消息头，可以重新设置它的值：
    headers = curl_slist_append(headers, "Accept: Agent-007"); 
headers = curl_slist_append(headers, "Host: munged.host.line");
  • 删除消息头
    对于一个已经存在的消息头，设置它的内容为空，libcurl在发送请求时就不会同时提交该消息头：
    headers = curl_slist_append(headers, "Accept:");
六、多线程问题

首先一个基本原则就是：绝对不应该在线程之间共享同一个libcurl handle(CURL *对象)，不管是easy handle还是multi handle（本文只介绍easy_handle）。一个线程每次只能使用一个handle。

七、关于密码####

客户端向服务器发送请求时，许多协议都要求提供用户名与密码。libcurl提供了多种方式来设置它们。

一些协议支持在URL中直接指定用户名和密码，类似于： protocol://user:password@example.com/path/。libcurl能正确的识别这种URL中的用户名与密码并执行 相应的操作。如果你提供的用户名和密码中有特殊字符，首先应该对其进行URL编码。

也可以通过CURLOPT_USERPWD属性来设置用户名与密码。curl_easy_setopt(easy_handle, CURLOPT_USERPWD, "user_name:password");

有时候在访问代理服务器的时候，可能时时要求提供用户名和密码进行用户身份验证。这种情况下，libcurl提供了另 一个属性CURLOPT_PROXYUSERPWD：
curl_easy_setopt(easy_handle, CURLOPT_PROXYUSERPWD, "user_name:password");

在UNIX平台下，访问FTP的用户名和密码可能会被保存在$HOME/.netrc文件中。libcurl支持直接从这个文件中获取用户名与密码：curl_easy_setopt(easy_handle, CURLOPT_NETRC, 1L);

在使用SSL时，可能需要提供一个私钥用于数据安全传输，通过CURLOPT_KEYPASSWD来设置私钥：
curl_easy_setopt(easy_handle, CURLOPT_KEYPASSWD, "keypassword");

libcurl各种函数使用方法资料：
https://curl.haxx.se/libcurl/c/options-in-examples.html

文章来源：
http://www.cnblogs.com/moodlxs/archive/2012/10/15/2724318.html

Jimmy1224
关注
专栏目录
C++ libcurl 库 实现http通讯
萧海的博客
09-14 1261
1 缘起 　　在curl的官方网站 **http://curl.haxx.se/download.html** 提供编译好libcurl包，用于老外的使用的 VC++编译器过高，本人使用VC2010，所以不兼容，所以参照网上的文章，一步一步搭建起基于OpenSSL和OpenSSH的的libcurl,能 够支持Https协议。  　　最后写一个demod工程，演示下libcurl强大的...
linux下c/c++方式访问curl的帮助手册
热门推荐
技术资料库
08-23 1万+
linux下c/c++方式访问curl的帮助手册
C++ 用libcurl库进行http通讯网络编程 - 绿色冰点 - 博客园1
08-03
C++ 使用libcurl库进行HTTP通信网络编程是一个常见的任务，libcurl是一个强大的开源库，它提供了多种网络协议的支持，包括HTTP、HTTPS、FTP等。在C++中使用libcurl，可以方便地实现网络请求和数据传输。以下是关于...
C++ 用libcurl库进行http通讯网络编程, my write test ok
最新发布
小硕算法工程师
07-30 708
libCurl需要读取数据传递给远程主机时将调用CURLOPT_READFUNCTION指定的函数，函数原型是：size_t function(void *ptr, size_t size, size_t nmemb,void *stream). CURLOPT_READDATA 表明CURLOPT_READFUNCTION函数原型中的stream指针来源。该函数是curl中非常重要的函数，curl所有设置都是在该函数中完成的，该函数的设置选项众多，注意本节的阐述的只是部分常见选项。
C/C++ 用libcurl库进行http通讯网络编程（嵌入式开发板）
kingkill315的博客
09-20 1261
（转载，非常好，免得丢失，加上自己的在linux上的测试） 一、LibCurl基本编程框架 二、一些基本的函数 三、curl_easy_setopt函数部分选项介绍 四、curl_easy_perform 函数说明（error 状态码） 五、libcurl使用的HTTP消息头 六、获取http应答头信息 七、多线程问题 八、什么时候libcurl无法正常工作 九、关于密码 十、HTTP验证 十一、...
Base64编码和解码-Libcurl库进行http通讯.zip
08-13
总的来说，这个压缩包提供了C++环境中使用`Libcurl`库进行Base64编码和解码的实例，这对于理解如何在实际项目中处理二进制数据和网络通信非常有帮助。开发者可以借此深入学习`Libcurl`的用法，提高其在网络编程领域...
libcurl通讯库
03-12
**libcurl通讯库详解** libcurl是一个强大的开源库，它为开发者提供了在各种操作系统上进行HTTP、HTTPS及其他多种网络协议通信的能力。这个跨平台的库允许应用程序通过简单易用的API来发送和接收数据，极大地简化了...
c++中libcurl库
05-18
libcurl
网络编程HttpServer c++实现
06-03
c++源代码 加 “使用说明.word”文档 能运行
curl c++使用
07-12
仅供自己备份使用。 curl c++ 使用实例，项目中使用，没有改动直接贴过来。 curl https访问，curl-7.60.0源码版本
基于libcurl 的http异步请求
12-02
最近工作关系，需要一个c++实现的异步http请求功能，在网上查了些质料，最后决定用libcurl。不过libcurl编译起来比较困难，研究了很长时间才弄明白。这个小程序只是简单的使用线程池实现了libcurl的异步请求功能，很多地方还需要优化，之所有厚颜上传到这里，主要有有三个目的。 一个是回报这些天在CSDN上得到的帮助，希望可以帮助到后来的人； 二是感于libcurl编译实在繁琐，如果有需要这个库又一时编译不通过的人，可以直接拿程序中的libcurl库文件用； 三是希望得到CSDN上大神们的指点。 如果要使用这个程序所设计的异步http请求功能，可以继承 HttpBaseRequest 类，重写virtual void OnComplete(CURLcode code);方法来处理应答消息。 如果有其他与本程序相关的问题
C++网络开发，最佳选择libcurl库最新版(20190726)
07-26
截至2019.7.26日，最新版libcurl第三方库，做C++网络开发，最佳选择
C++ 使用 curl 进行 http 请求（GET、POST、Download）的封装
weixin_34319640的博客
08-14 755
修改自网路   CommonTools.h   /* * CommonTools.h * * Created on: 2018年8月2日 * Author: didi */ #include <iostream> #include <curl/curl.h> #include "zlib.h" #include <vector> #in...
C++socket网络编程(跨平台)实战HTTP服务器(二)
weixin_34266504的博客
07-15 192
使用Socket创建TCP服务器 1首先了解一下TCP1TCP是面向连接的,必须是三次握手之后2TCP提供可靠连接,实现丢失重传,RTT的估算物理 网卡 网线都会影响 这个丢包3TCP通过给所发数据的每一个段管理一个序列号进行排序. 没一个包都有一个序号,由底层按照序列号发送给你4TCP提供流量控制和拥塞控制:通过窗口拥塞窗口可以限制流量的...
C++中的网络编程：HTTP协议和多线程网络编程
程序员光剑
07-14 1901
作者：禅与计算机程序设计艺术 网络编程是现代IT行业的一个重要方向。在进行网络编程时，需要掌握HTTP协议，了解TCP/IP协议族的工作方式以及多线程网络编程的方法。下面将会通过一个实际案例，带领大家学习并应用C++实现HTTP请求、响应、客户端处理和服务器端编程。 本文假设读者对C++有一定的了解，同时熟悉HTTP协议的基
curl 使用范例 c++
qiulu12345的专栏
02-23 1754
1.curl_global_init(CURL_GLOBAL_ALL); m_CurlHandle = curl_easy_init(); //初始化环境，构造handle 2. struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Accept: */*"); //构造头3. 回调的函数后面再讲curl
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值