libcurl Cookie 详解

libcurl关于Cookie的一些选项:

CURLOPT_COOKIE

用来指定一个Cookie,用来在之后的http请求中发送这个Cookie。

CURLOPT_COOKIEFILE

告诉libcurl激活cookie引擎,然后读取指定文件来初始化Cookie,只读。

CURLOPT_COOKIEJAR

告诉libcurl激活cookie引擎,当easy handle被关闭,保存所有已知的Cookie到cookie jar文件,只写。

CURLOPT_COOKIELIST

提供单个的Cookie加入内部的Cookie存储引擎。可以传递http头格式也可以传递netscape 格式。这个也可以用来刷新Cookies。

CURLINFO_COOKIELIST

将Cookie信息从内部Cookie存储里导出,导出格式为链表。

CURLOPT_COOKIE

这个函数可以给http请求设置Cookie 用法如下:
curl_easy_setopt(curl, CURLOPT_COOKIE, "tool=curl; fun=yes;");
这个选项显式对发出的http请求的Cookie进设置,如果由于身份验证,随后的重定向或类似的操作完成了多个请求,则他们都将传递此Cookie。这句话的意思是重定向类操作会继续传递此Cookie。

通过这个选项设置Cookie是与内部的Cookie存储引擎分开的,内部的Cookie存储引擎不会被此选项修改。假如你开启Cookie存储引擎你又导入一个同名的Cookie(或者服务器已经设置了这样一个Cookie),那么你设置的Cookie将不会影响引擎内部的Cookie。向服务器发出的请求会发送两个Cookie都发。想要替换引擎内部的Cookie可以使用CURLOPT_COOKIELIST这个选项。

多次调用这个选项只有最后一次调用会被使用。
这个选项不会开启Cookie Engine。你可以使用CURLOPT_COOKIEFILE或者CURLOPT_COOKIEJAR去开启Cookie引擎来达到自动分析和发送Cookie的功能。

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

  curl_easy_setopt(curl, CURLOPT_COOKIE, "tool=curl; fun=yes;");

  curl_easy_perform(curl);
}

CURLOPT_COOKIELIST

这个选项的参数可以为一行Netscape/Mozilkla格式或者http头(Set-Cookie:…)。他会打开Cookie引擎。也会将单个Cookie加入内部Cookie存储。

如果你使用这个选项并且有多个请求要发送的时候要谨慎。如果你使用Set-Cookie格式没有指定域名的话那这个Cookie将会发送给所有的请求(包括重定向),而且这个Cookie无法被服务器SetCookie更改。如果服务器SetCookie时已经有一个同名的Cookie时,这个Cookie不会被替换,他会将两者都传递给该服务器,这可能不是你想要的。要解决这个问题,请在Set-Cookie中设置一个域(这样做将包括子域)或使用Netscape格式。如示例所示。

/* 这个例子演示了如何将Netscape格式的COokie的内联导入, 您可以将cookie设置为HttpOnly,以防XSS攻击#HttpOnly_到主机名。 如果cookie稍后由浏览器导入会很有用*/ #define SEP "\t" /* Tab separates the fields */ char *my_cookie = "example.com" /* Hostname */ SEP "FALSE" /* Include subdomains */ SEP "/" /* Path */ SEP "FALSE" /* Secure */ SEP "0" /* Expiry in epoch time format. 0 == Session */ SEP "foo" /* Name */ SEP "bar"; /* Value */ /* my_cookie 通过 CURLOPT_COOKIELIST导入*/ curl_easy_setopt(curl, CURLOPT_COOKIELIST, my_cookie); /* 在cookie.txt里面的cookie将不会被导入直到在传输前正确。如果Cookie里面有相同的hostname,path或者在my_cookies里存在将会被跳过。因为libcurl已经通过my_cookie导入被称为”活着”的Cookie。活着的cookie不可以被通过读入文件的Cookie替换。。 */ curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "cookies.txt"); /* import */ /* Cookie的导出是在curl_easy_cleanup被调用之后进行的。服务器可以增加、删除、修改Cookie。被跳过的的cookie不会被导入 */ curl_easy_setopt(curl, CURLOPT_COOKIEJAR, "cookies.txt"); /* export */ curl_easy_perform(curl); /* cookies imported from cookies.txt */ curl_easy_cleanup(curl); /* cookies exported to cookies.txt */

CURLOPT_COOKIEJAR

这个选项的功能是将Cookie存储到一个文件。
如果设置了这个选项libcurl将会在curl_easy_cleanup被调用的时候将cookie与入文件。如果没有已经的cookie,会以-为文件名替换。他会还启用此会话的cookie。所以如果你follow a location,它将会发送对应的Cookie

libcurl不会从cookie jar文件中读取任何cookie。如果你想从 文件要读取cookie请使用CURLOPT_COOKIEFILE。

如果cookie jar在curl_wasy_clean调用时候不能被创建或写入,libcurl不会去报告这个错误。使用CURLOPT_VERBOSE或CURLOPT_DEBUGFUNCTION会有一个警告显示。



自己7.43.0 cookie被Set-Cookie 格式并且没有domain 时,将不会导出。

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/foo.bin");

  /*当调用cleanup的时候导出cookie到文件*/
  curl_easy_setopt(curl, CURLOPT_COOKIEJAR, "/tmp/cookies.txt");

  ret = curl_easy_perform(curl);

  /* 关闭curl, 写入cookie! */
  curl_easy_cleanup(curl);
}
上一篇:php网络请求


下一篇:PHP CURL调用接口