一、使用 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()
释放内存
二、函数简介:
#include <curl/curl.h>
1、
CURLcode curl_global_init(long flags); // Libcurl 初始化
//参数 flags:
CURL_GLOBAL_ALL //初始化所有的可能的调用
CURL_GLOBAL_SSL //初始化支持安全套接字层
CURL_GLOBAL_WIN32 //初始化 win32 套接字库
CURL_GLOBAL_NOTHING //没有额外的初始化
注意!! 此函数只能调用一次(在调用curl_global_cleanup()
函数后可再次调用),如果这个函数在curl_easy_init()
函数调用时还没调用,它将由 libcurl 库自动调用,所以多线程下最好主动调用该函数以防止在线程中curl_easy_init()
时多次调用。curl_global_init()
是不能保证线程安全的,所以不要在每个线程中都调用curl_global_init()
,应该将curl_global_init()
函数的调用放在主线程中。
2、
CURL *curl_easy_init();
curl_easy_init()
用来初始化一个 CURL 的指针,相应的在调用结束时要用curl_easy_cleanup()
函数清理。一般curl_easy_init()
意味着一个会话的开始。它会返回一个easy_handle
(CURL*对象),一般都用在easy系列的函数中。
3、
CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);
// handle 参数:curl_easy_init 函数返回的句柄
// option 参数:
CURLOPT_URL //设置访问 URL,如:"http://www.baidu.com"
CURLOPT_WRITEFUNCTION /*函数将在 libcurl 接收到数据后被调用,因此函数多做数据保存的功能,如处理下载文件,即第三个参数
为一个函数*/
size_t function(void *ptr, size_t size, size_t nmemb, void *stream); //指定函数原型 (格式)
CURLOPT_WRITEDATA //用于表明 CURLOPT_WRITEFUNCTION 函数中的 stream 指针的来源
/*如果你没有通过 CURLOPT_WRITEFUNCTION 属性给 easy handle 设置回调函数,libcurl 会提供一个默认的回调函数,它只是简单的将接
收到的数据打印到标准输出。你也可以通过 CURLOPT_WRITEDATA 属性给默认回调函数传递一个已经打开的文件指针,用于将数据输出到文件里
*/
CURLOPT_READFUNCTION // libCurl 需要读取数据传递给远程主机时将调用 CURLOPT_READFUNCTION 指定的函数
size_t function(void *ptr, size_t size, size_t nmemb, void *stream); //指定函数原型 (格式)
CURLOPT_READDATA //表明 CURLOPT_READFUNCTION 函数原型中的 stream 指针来源
// parameter 参数:取决于第二个参数,可以是函数的指针,也可以是某个对象的指针,也可以是个 long 型的变量
此函数几乎所有的 curl 程序都要频繁的使用它。它告诉 curl 库。程序将有如何的行为。比如要查看一个网页的 html 代码等。
4、
CURLcode curl_easy_perform(CURL *handle);
在初始化 CURL 类型的指针以及curl_easy_setopt()
完成后调用。让我们设置的 option 运作起来。
5、
void curl_global_cleanup(void);
结束 libcurl 使用的时候,用curl_global_cleanup()
来对curl_global_init()
做清理工作。
注意!!curl_global_cleanup()
是不能保证线程安全的,所以不要在每个线程中都调用curl_global_cleanup()
,应该将该函数的调用放在主线程中。
6、
char *curl_version(); //打印当前 libcurl 的版本
三、代码示例:
1、基本的 http GET/POST 操作:
#include <stdio.h>
#include <curl/curl.h>
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 指向的文件
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");
}