一：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（）釋放內存

二：重要函數
1、CURLcode curl_global_init(long flags); //初始化libcurl
描述：這個函數只能用一次。(其實在調用curl_global_cleanup 函數后仍然可再用),如果這個函數在curl_easy_init函數調用時還沒調用，它全由libcurl庫自動完成。
參數：flags
CURL_GLOBAL_ALL              //初始化所有的可能的調用。
CURL_GLOBAL_SSL              //初始化支持安全套接字層。
CURL_GLOBAL_WIN32            //初始化win32套接字庫。
CURL_GLOBAL_NOTHING          //沒有額外的初始化。

2、void curl_global_cleanup(void);
描述：在結束libcurl使用的時候，用來對curl_global_init做的工作清理。類似於close的函數。

3、char *curl_version( );
描述: 打印當前libcurl庫的版本。

4、CURL *curl_easy_init( ); //得到 easy interface型指針
描述:curl_easy_init用來初始化一個CURL的指針(有些像返回FILE類型的指針一樣). 相應的在調用結束時要用curl_easy_cleanup函數清理.
一般curl_easy_init意味着一個會話的開始. 它的返回值一般都用在easy系列的函數中.
5、void curl_easy_cleanup(CURL *handle); //釋放內存
描述:這個調用用來結束一個會話.與curl_easy_init配合着用.
參數:CURL類型的指針.

6、CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter); //設置的傳輸選項，實現回調函數以完成用戶特定任務
描述: 這個函數最重要了.幾乎所有的curl 程序都要頻繁的使用它.它告訴curl庫.程序將有如何的行為. 比如要查看一個網頁的html代碼等.(這個函數有些像ioctl函數)參數:
(1) CURL類型的指針
(2) 各種CURLoption類型的選項.(都在curl.h庫里有定義,man 也可以查看到)
(3) parameter 這個參數既可以是個函數的指針,也可以是某個對象的指針,也可以是個long型的變量.它用什么這取決於第二個參數.
(4) CURLoption 這個參數的取值很多.具體的可以查看man手冊.

7、CURLcode curl_easy_perform(CURL *handle); //完成傳輸任務;返回0意味一切ok，非0代表錯誤發生
描述:這個函數在初始化CURL類型的指針以及curl_easy_setopt完成后調用. 就像字面的意思所說perform就像是個舞台.讓我們設置的option 運作起來.
參數:CURL類型的指針.
補充：
(1)在連接過程中，如果出現異常，如網線拔掉，返回CURLE_COULDNT_CONNECT;

(2)在下載過程中，即已經連接上了，后面如果出現異常，如網線拔掉,返回CURLE_OPERATION_TIMEOUTED

8、curl_slist_append(struct curl_slist * list, const char * string ); //add a string to an slist
9、curl_slist_free_all(slist); // free the list again

10、curl_formadd(struct curl_httppost ** firstitem, struct curl_httppost ** lastitem, ...) //add a section to a multipart/formdata HTTP POST

11、其它
/****************************************************************/
libcurl note（Http應用)
設置Callback function處理Http頭，返回內容，進度
CURLOPT_WRITEFUNCTION
CURLOPT_WRITEDATA

CURLOPT_HEADERFUNCTION
CURLOPT_HEADERDATA

CURLOPT_NOPROGRESS
CURLOPT_PROGRESSFUNCTION
CURLOPT_PROGRESSDATA

設置連接等待時間，傳輸等待時間：

CURLOPT_TIMEOUT:
CURLOPT_CONNECTIONTIMEOUT:

設置重定位URL：

CURLOPT_FOLLOWLOCATION

實現斷點續傳：
CURLOPT_RANGE:
CURLOPT_RESUME_FROM:

CURLOPT_RANGE:
CURLOPT_RESUME_FROM:

注：在我的測試中這兩個參數無效。

設置RANGE后下載全部數據，而不是后續數據;

設置RESUME_FROM后，程序無響應。

Http頭設置：
Range: bytes=xx-       [可以用來實現斷點續傳]
User-Agent: xx
Location:              [網頁重定位 url]
Set-Cookie:            [Cookie]
Content-Length:        [報文長度]
Content-Type:            [報文類型]
/****************************************************************/

三：應用實例
1、為什么要使用libcurl,
(1)作為http的客戶端，可以直接用socket連接服務器，然后對到的數據進行http解析，但要分析協議頭，實現代理…這樣太麻煩了。
(2)libcurl是一個開源的客戶端url傳輸庫，支持FTP，FTPS，TFTP，HTTP，HTTPS，GOPHER，TELNET，DICT，FILE和LDAP，支持Windows，Unix，Linux等平台，簡單易用，且庫文件占用空間不到200K。

2、get和post方式
客戶端在http連接時向服務提交數據的方式分為get和post兩種
(1)Get方式將所要傳輸的數據附在網址后面，然后一起送達服務器，它的優點是效率比較高；缺點是安全性差、數據不超過1024個字符、必須是7位的ASCII編碼；查詢時經常用此方法。
(2)Post通過Http post處理發送數據，它的優點是安全性較強、支持數據量大、支持字符多；缺點是效率相對低；編輯修改時多使用此方法。

3、cookie與session
(1)cookie是發送到客戶瀏覽器的文本串句柄，並保存在客戶機硬盤上，可以用來在某個Web站點會話之間持久地保持數據。cookie在客戶端。
(2)session是訪問者從到達某個特定主頁到離開為止的那段時間。每一訪問者都會單獨獲得一個session，實現站點多個用戶之間在所有頁面中共享信息。session在服務器上。
(3)libcurl中使用cookie,保存cookie, 使之后的鏈接與此鏈接使用相同的cookie
(3.1)在關閉鏈接的時候把cookie寫入指定的文件: curl_easy_setopt(curl, CURLOPT_COOKIEJAR, "/tmp/cookie.txt");
(3.2)取用現在有的cookie，而不重新得到cookie: curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "/tmp/cookie.txt");

4、http與https的區別
(1)Http是明文發送，任何人都可以攔截並讀取內容
(2)Https是加密傳輸協議，用它傳輸的內容都是加密過的，https是http的擴展，其安全基礎是SSL協議
5、base64編碼
(1)如果要傳一段包含特殊字符比較多的數據，直接上傳就需要處理轉意符之類的很多問題，用base64編碼，它可以把數據轉成可讀的字串，base64由a-z, A-Z, +/總計64個字符組成。
(2)由於base64的組成部分有加號，而加號是url中的轉意字符，所以無論是get方式還是post，傳到服務器的過程中，都會把加號轉成空格，所以在傳base64之前需要把base64編碼后的加號替換成”%2B”，這樣就可以正常發送了。

6、curl_setop()函數中的參數中文說明

curl_setopt()函數將為一個CURL會話設置選項。option參數是你想要的設置，value是這個選項給定的值。下列選項的值將被作為長整形使用(在option參數中指定)
代碼例程

libcurl 使用筆記 - 喜歡初美 - 博客大巴 - Google Chrome (2013/7/26 17:50:53)

使用 cURL 和 libcurl 通過 Internet 進行對話 - Google Chrome (2013/7/26 16:58:48)

fatal error: curl/curl.h: No such file or directory | Ubuntu 12.04 from alexsleat.co.uk - Google Chr (2013/7/26 16:49:05)

curl_easy_getinfo() -- 從 curl 句柄里獲得附加信息|Functions - 曲徑通幽 - Standing on the shoulders of giants - Goo (2013/5/23 17:52:30)

C++ 用libcurl庫進行http通訊網絡編程 - 綠色冰點 - 博客園 - Google Chrome (2013/5/23 16:59:53)

Linux libcurl使用（一）(收藏)_留風的貝殼_百度空間 - Google Chrome (2013/5/23 15:17:01)

LibCurl編程 http://wangjiajun53880.blog.163.com/blog/static/117001394200992011257363/

Linux 2009-10-20 13:07 閱讀評論字號：大大中中小小

2.1 LibCurl編程流程

在基於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（）釋放內存

在整過過程中設置curl_easy_setopt()參數是最關鍵的，幾乎所有的libcurl程序都要使用它。

2.2 重要函數

1.CURLcode curl_global_init(long flags);

描述：
這個函數只能用一次。(其實在調用curl_global_cleanup 函數后仍然可再用)
如果這個函數在curl_easy_init函數調用時還沒調用，它講由libcurl庫自動完成。
參數：flags
CURL_GLOBAL_ALL                      //初始化所有的可能的調用。
CURL_GLOBAL_SSL                      //初始化支持安全套接字層。
CURL_GLOBAL_WIN32            //初始化win32套接字庫。
CURL_GLOBAL_NOTHING         //沒有額外的初始化。

2 void curl_global_cleanup(void);
描述：在結束libcurl使用的時候，用來對curl_global_init做的工作清理。類似於close的函數。
3 char *curl_version( );
描述: 打印當前libcurl庫的版本。
4 CURL *curl_easy_init( );
描述:
curl_easy_init用來初始化一個CURL的指針(有些像返回FILE類型的指針一樣). 相應的在調用結束時要用curl_easy_cleanup函數清理.
一般curl_easy_init意味着一個會話的開始. 它的返回值一般都用在easy系列的函數中.
5 void curl_easy_cleanup(CURL *handle);
描述:
這個調用用來結束一個會話.與curl_easy_init配合着用.
參數:
CURL類型的指針.
6 CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);
描述: 這個函數最重要了.幾乎所有的curl 程序都要頻繁的使用它.它告訴curl庫.程序將有如何的行為. 比如要查看一個網頁的html代碼等.(這個函數有些像ioctl函數)參數:
1 CURL類型的指針
2 各種CURLoption類型的選項.(都在curl.h庫里有定義,man 也可以查看到)
3 parameter 這個參數既可以是個函數的指針,也可以是某個對象的指針,也可以是個long型的變量.它用什么這取決於第二個參數.
CURLoption 這個參數的取值很多.具體的可以查看man手冊.
7 CURLcode curl_easy_perform(CURL *handle);描述:這個函數在初始化CURL類型的指針以及curl_easy_setopt完成后調用. 就像字面的意思所說perform就像是個舞台.讓我們設置的
option 運作起來.參數:
CURL類型的指針.

3.3 curl_easy_setopt函數介紹

本節主要介紹curl_easy_setopt中跟http相關的參數。注意本節的闡述都是以libcurl作為主體，其它為客體來闡述的。

1. CURLOPT_URL
設置訪問URL

2. CURLOPT_WRITEFUNCTION，CURLOPT_WRITEDATA
回調函數原型為：size_t function( void *ptr, size_t size, size_t nmemb, void *stream); 函數將在libcurl接收到數據后被調用，因此函數多做數據保存的功能，如處理下載文件。CURLOPT_WRITEDATA 用於表明CURLOPT_WRITEFUNCTION函數中的stream指針的來源。

3. CURLOPT_HEADERFUNCTION，CURLOPT_HEADERDATA
回調函數原型為 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

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，指定你希望開始傳遞的

偏移量。

3.4 curl_easy_perform 函數說明（error 狀態碼）

該函數完成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
讀本地文件錯誤

3.1 獲取html網頁

view plaincopy to clipboardprint?
#include <stdio.h>;
#include <stdlib.h>;
#include <unistd.h>;

#include <curl/curl.h>;
#include <curl/types.h>;
#include <curl/easy.h>;

FILE *fp; //定義FILE類型指針

size_t write_data(void *ptr, size_t size, size_t nmemb, void *stream) //這個函數是為了符合CURLOPT_WRITEFUNCTION, 而構造的
{
    int written = fwrite(ptr, size, nmemb, (FILE *)fp);
    return written;
}

int main(int argc, char *argv[])
{
    CURL *curl;

    curl_global_init(CURL_GLOBAL_ALL);
    curl=curl_easy_init();
    curl_easy_setopt(curl, CURLOPT_URL, argv[1]);

    if((fp=fopen(argv[1],"w"))==NULL)
    {
        curl_easy_cleanup(curl);
        exit(1);
    }
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data); //CURLOPT_WRITEFUNCTION 將后繼的動作交給write_data函數處理
    curl_easy_perform(curl);
    curl_easy_cleanup(curl);
    exit(0);
}
#include <stdio.h>;
#include <stdlib.h>;
#include <unistd.h>;

#include <curl/curl.h>;
#include <curl/types.h>;
#include <curl/easy.h>;

FILE *fp; //定義FILE類型指針

size_t write_data(void *ptr, size_t size, size_t nmemb, void *stream) //這個函數是為了符合CURLOPT_WRITEFUNCTION, 而構造的
{
int written = fwrite(ptr, size, nmemb, (FILE *)fp);
return written;
}

int main(int argc, char *argv[])
{
CURL *curl;

    curl_global_init(CURL_GLOBAL_ALL);
    curl=curl_easy_init();
    curl_easy_setopt(curl, CURLOPT_URL, argv[1]);

    if((fp=fopen(argv[1],"w"))==NULL)
    {
        curl_easy_cleanup(curl);
        exit(1);
    }
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data); //CURLOPT_WRITEFUNCTION 將后繼的動作交給write_data函數處理
    curl_easy_perform(curl);
    curl_easy_cleanup(curl);
    exit(0);
}

把獲得的html代碼存入相應的文件中.看下面一個例子

#include <curl/curl.h>;
#include <curl/types.h>;
#include <curl/easy.h>;

FILE *fp; //定義FILE類型指針

int main(int argc, char *argv[])
{
CURL *curl;

    curl_global_init(CURL_GLOBAL_ALL);
    curl=curl_easy_init();
    curl_easy_setopt(curl, CURLOPT_URL, argv[1]);

從ftp站點下載文件的例子.

view plaincopy to clipboardprint?
#include <stdio.h>;
#include <curl/curl.h>;
#include <curl/types.h>;
#include <curl/easy.h>;

struct FtpFile   //定義一個結構為了傳遞給my_fwrite函數.可用curl_easy_setopt的CURLOPT_WRITEDATA選項傳遞
{
        char *filename;
        FILE *stream;
};

int my_fwrite(void *buffer, size_t size, size_t nmemb, void *stream)
{
        struct FtpFile *out=(struct FtpFile *)stream; // stream指針其實就是指向struct FtpFile ftpfile的
        if(out && !out->stream)
        {
                out->;stream=fopen(out->filename, "wb"); //沒有這個流的話就創建一個名字是out->filename.
                if(!out->stream)
                return -1;
        }
        return fwrite(buffer, size, nmemb, out->stream);
}

int main(int argc, char *argv[])
{
        CURL *curl;
        CURLcode res;
        struct FtpFile ftpfile={argv[2],NULL}; //初始化一個FtpFile結構
        curl_global_init(CURL_GLOBAL_DEFAULT);

        curl = curl_easy_init();
        if(curl)
        {
                curl_easy_setopt(curl, CURLOPT_URL,argv[1]);
                curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, my_fwrite);
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, &ftpfile); //給相關函數的第四個參數傳遞一個結構體的指針
                curl_easy_setopt(curl, CURLOPT_VERBOSE, TRUE); //CURLOPT_VERBOSE 這個選項很常用用來在屏幕上顯示對服務器相關操作返回的信息

                res = curl_easy_perform(curl);
                curl_easy_cleanup(curl);

                if(CURLE_OK != res)
                        fprintf(stderr, "curl told us %d\n", res);
        }
        if(ftpfile.stream)
        fclose(ftpfile.stream);
        curl_global_cleanup();

        return 0;
}
#include <stdio.h>;
#include <curl/curl.h>;
#include <curl/types.h>;
#include <curl/easy.h>;

struct FtpFile   //定義一個結構為了傳遞給my_fwrite函數.可用curl_easy_setopt的CURLOPT_WRITEDATA選項傳遞
{
        char *filename;
        FILE *stream;
};

int my_fwrite(void *buffer, size_t size, size_t nmemb, void *stream)
{
        struct FtpFile *out=(struct FtpFile *)stream; // stream指針其實就是指向struct FtpFile ftpfile的
        if(out && !out->stream)
        {
                out->;stream=fopen(out->filename, "wb"); //沒有這個流的話就創建一個名字是out->filename.
                if(!out->stream)
                return -1;
        }
        return fwrite(buffer, size, nmemb, out->stream);
}

int main(int argc, char *argv[])
{
        CURL *curl;
        CURLcode res;
        struct FtpFile ftpfile={argv[2],NULL}; //初始化一個FtpFile結構
        curl_global_init(CURL_GLOBAL_DEFAULT);

        curl = curl_easy_init();
        if(curl)
        {
                curl_easy_setopt(curl, CURLOPT_URL,argv[1]);
                curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, my_fwrite);
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, &ftpfile); //給相關函數的第四個參數傳遞一個結構體的指針
                curl_easy_setopt(curl, CURLOPT_VERBOSE, TRUE); //CURLOPT_VERBOSE 這個選項很常用用來在屏幕上顯示對服務器相關操作返回的信息

res = curl_easy_perform(curl);
curl_easy_cleanup(curl);

                if(CURLE_OK != res)
                        fprintf(stderr, "curl told us %d\n", res);
        }
        if(ftpfile.stream)
        fclose(ftpfile.stream);
        curl_global_cleanup();

return 0;
}

進度條實例??顯示文件下載進度

view plaincopy to clipboardprint?
// 采用CURLOPT_NOPROGRESS， CURLOPT_PROGRESSFUNCTION    CURLOPT_PROGRESSDATA 實現文件傳輸進度提示功能

//函數采用了gtk庫，故編譯時需指定gtk庫

//函數啟動專門的線程用於顯示gtk 進度條bar

#include <stdio.h>

#include <gtk/gtk.h>

#include <curl/curl.h>

#include <curl/types.h> /* new for v7 */

#include <curl/easy.h> /* new for v7 */

GtkWidget *Bar;

////這個函數是為了符合CURLOPT_WRITEFUNCTION而構造的

//完成數據保存功能

size_t my_write_func(void *ptr, size_t size, size_t nmemb, FILE *stream)

{

return fwrite(ptr, size, nmemb, stream);

}

//這個函數是為了符合CURLOPT_READFUNCTION而構造的

//數據上傳時使用

size_t my_read_func(void *ptr, size_t size, size_t nmemb, FILE *stream)

{

return fread(ptr, size, nmemb, stream);

}

//這個函數是為了符合CURLOPT_PROGRESSFUNCTION而構造的

//顯示文件傳輸進度，t代表文件大小，d代表傳輸已經完成部分

int my_progress_func(GtkWidget *bar,

                     double t, /* dltotal */

                     double d, /* dlnow */

                     double ultotal,

                     double ulnow)

{

/* printf("%d / %d (%g %%)\n", d, t, d*100.0/t);*/

gdk_threads_enter();

gtk_progress_set_value(GTK_PROGRESS(bar), d*100.0/t);

gdk_threads_leave();

return 0;

}

void *my_thread(void *ptr)

{

CURL *curl;

CURLcode res;

FILE *outfile;

gchar *url = ptr;

curl = curl_easy_init();

if(curl)

{

    outfile = fopen("test.curl", "w");

    curl_easy_setopt(curl, CURLOPT_URL, url);

    curl_easy_setopt(curl, CURLOPT_WRITEDATA, outfile);

    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, my_write_func);

    curl_easy_setopt(curl, CURLOPT_READFUNCTION, my_read_func);

    curl_easy_setopt(curl, CURLOPT_NOPROGRESS, 0L);

    curl_easy_setopt(curl, CURLOPT_PROGRESSFUNCTION, my_progress_func);

    curl_easy_setopt(curl, CURLOPT_PROGRESSDATA, Bar);

    res = curl_easy_perform(curl);

    fclose(outfile);

    /* always cleanup */

    curl_easy_cleanup(curl);

}

return NULL;

}

【Curl (libcurl) 開發】Cocos2dx之libcurl（curl_easy）的編程教程（幫助手冊）！ | 黑米GameDev街區 - Google Chrome (2013/5/23 14:56:10)

本篇介紹使用libcurl編程的一般原則和一些基本方法。本文主要是介紹 c 語言的調用接口，同時也可能很好的適用於其他類 c 語言的接口。

libcurl庫背后的開發人員投入了相當大的努力確保libcurl可以在很多不同的系統和環境里工作。

程序必須初始化一些libcurl的全局函數。這意味着不管你准備使用libcurl多少次，你都應該，且只初始化一次。當你的程序開始的時候，使用

這個函數需要一個參數來告訴它如何來初始化。使用CURL_GLOBAL_ALL ,它將用通常是比較好的默認參數來初始化所有已知的內部子模塊。還有兩個可選值：

這個參數只被用在windows 操作系統上。它讓libcurl初始化win32套接字的的東西。沒有正確的初始化，你的程序將不能正確的使用套接字。你應該只為每個程序做一次這樣的操作，如果你的程序的其他庫這樣了，你就不要再讓libcurl這樣做。

這個參數會使libcurl具有SSL的能力。你應該只為每個程序做一次這樣的操作，如果你的程序的其他庫這樣了，你就不要再讓libcurl這樣做。

libcurl有個默認的保護機制，檢測如果curl_global_init沒有在curl_easy_perform之前被調用，那么libcurl會猜測該使用的初始化模式來執行程序。請注意，依靠默認的保護機制來這么做一點都不好。

當程序不再使用libcurl，請調用curl_global_cleanup函數來對應初始化函數所做的工作，它會做逆向的工作來清理curl_global_init所初始化的資源。

請避免重復的調用curl_global_init和 curl_global_cleanup。他們每個僅被調用一次。

確定libcurl所提供功能的最佳辦法是在運行的時候而不是在編譯的時候。通過調用curl_version_info函數，然后查看返回信息的結構體，你知道當前的libcurl版本所支持的功能了。

首先介紹libcurl的簡單接口(easy interface)，這些接口都有curl_easy的前綴。 libcurl的最近版本還提供了復雜接口(multi interface)。更多關系該接口的信息將另作討論，為了更好的理解復雜接口，你仍然需要先了解簡單接口。

為了使用簡單接口，你先需要創建一個簡單接口的句柄。每一個簡單接口的數據通信都需要這個句柄。一般來說，你需要為每個准備傳輸數據的線程使用一個句柄。但你絕不能在多線程里共享相同的句柄。

這個函數返回一個簡單接口句柄。接下來的操作力，可以在這個`easyhandle設置各種選項。在隨后的一個或者多次數據傳輸中，句柄只是一個邏輯實體。通過 curl_easy_setopt設置句柄的屬性和選項，它們控制隨后的數據傳輸。這些屬性和選項的設置一個保存在句柄里直到它再次被設置為其他值。多次網絡請求使用相同的句柄，它們的句柄選擇和屬性也是相同的。

很多用於設置libcurl屬性都是字符串，一個指向一段以0結尾數據。當你用字符串設置 curl_easy_setopt(），libcurl會復制這個字符串的一個副本，所以你在設置后不用再保存那個字符串的內存。

假如你希望得到指定URL上的遠程主機的數據資源到本地。如果你想自己處理得到的數據而不是直接顯示在標准輸出里，你可以寫一個符合下面原型的函數

你可以用類似下面這樣的代碼來控制libcurl將得到的數據傳遞到你寫的函數里

你還可以控制你的回調函數第四個參數得到的數據，用這樣的函數原型

使用這種原型，你可以很容易在你程序和被libcurl調用函數之間傳遞本地數據。使用 CURLOPT_WRITEDATA,libcurl不會處理你所傳遞的數據。

假如你沒用使用CURLOPT_WRITEFUNCTION設置回調函數，libcurl會有默認的處理。它只是把接收到的數據輸出到標准輸出里。你可以使用傳遞一個FILE *的打開文件參數，設置默認處理函數CURLOPT_WRITEDATA ,它把得到的數據存放在一個文件里。

這里有一個與平台有關的缺陷。有時候libcurl不能操作一個唄程序所打開的文件。如果你用CURLOPT_WRITEDATA給默認的回調函數傳遞一個打開的文件，程序可能崩潰。(CURLOPT_WRITEDATA 原來的名稱為CURLOPT_FILE,它們是同樣的工作機理)。

如果你以 win32 dll的方式使用libcurl，如果你設置了，CURLOPT_WRITEDATA ，也必須用CURLOPT_WRITEFUNCTION ，否則你會遇到程序崩潰。還有其他很多的選項可以設置，我們放在后面再詳細討論，接着往下看

curl_easy_perform函數將會連接遠程的站點，發送必要的命令和接受傳輸的數據。當它收到了數據，它就會調用我們先前設置的回調函數。這個函數可能一次得到一個字節或者幾千個字節。libcurl會盡可能多的，盡可能快的傳回數據。我們回調函數返回它所得到數據的大小。如果返回的數據大小與傳遞給它數據大小不一致，libcurl將會終止操作，並返回一個錯誤代碼。

當數據傳輸完成，curl_easy_perform返回一個代碼來告訴你是否成功。如果你僅返回一個代碼還不夠，你可以使用CURLOPT_ERRORBUFFER ,讓libcurl緩存許多可讀的錯誤信息

如果你還想傳輸其他數據，已有的句柄可以多次使用。記住，鼓勵你使用現有的句柄來傳輸其他數據，libcurl會嘗試已經先前已經建立好的連接。

對於某些協議，下載文件可能涉及到很多復雜的協議用來記錄信息，設置傳輸模式，更改當前的目錄並最終傳遞數據。傳遞一個文件的URL，libcurl會為你掌管所有細節，把文件從一台機器移動到兩一台機器。

最基本的原則是絕對不要同時在多個線程之間共享一個libcurl的句柄。確保任何時候一個句柄只是在一個線程里使用。你可以在多個線程之間傳遞句柄，但是你不能使用。

libcurl是線程安全的，除了以下兩種情況：信號量和SSL/TLS句柄。信號量用於超時失效名字解析(在域名解析的時候)。

如果你通過多線程方式來訪問HTTPS 或者 FTPS 網址，你可以使用底層的SSL庫，多線程庫。這些庫可能有它們獨有的要求，你要多加注意詳細參考

http://www.gnu.org/software/gnutls/manual/html_node/Multi_002dthreaded-applications.html

NSS 它宣稱是線程安全，沒有任何特殊的要求。 PolarSSL 未知。yassl 未知。axTLS 未知。

當你使用多線程的時候，你應當為所有的句柄設置CURLOPT_NOSIGNAL 選項。所有的時候都可以工作正常除了DNS查詢超時的時候。同樣，CURLOPT_DNS_USE_GLOBAL_CACHE 也不是線程安全的。

總是有各種原因導致網絡傳輸失敗。你可能設置錯誤的libcurl選項，誤解了libcurl某些選項的實際作用，或者遠程服務器返回libcurl一個非標准的應答。

當發生錯誤的時候，這里有一個黃金法:設置CURLOPT_VERBOSE 選項為1。這將導致libcurl顯示出所有發送的實體協議的細節，或者還有一些內部的信息和一些收到協議的數據(尤其是 FTP)。如果你使用HTTP ,CURLOPT_HEADER設為1,請求頭/響應頭也會被輸出,這些頭信息將出現在消息的內容中。

如果CURLOPT_VERBOSE 還不夠，你設置CURLOPT_DEBUGFUNCTION來調試你的數據。

libcurl盡量保持與協議無關性，就是上傳文件到遠程的FTP跟用PUT方式上傳數據到HTTP服務器和非常類似的。我們寫一個程序，很可能想libcurl按照我們的要求上傳數據。我需要設置如下函數原型的讀數據的回調函數

bufptr 參數指向一段准備上傳數據的緩沖區，nitem是這段緩沖區的大小，userp是一個用戶自定義指針，libcurl不對該指針作任何操作，它只是簡單的傳遞該指針。可以使用該指針在應用程序與libcurl之間傳遞信息。

curl_easy_setopt(easyhandle, CURLOPT_READFUNCTION, read_function);
curl_easy_setopt(easyhandle, CURLOPT_READDATA, &filedata);
Tell libcurl that we want to upload:
curl_easy_setopt(easyhandle, CURLOPT_UPLOAD, 1L);

有幾個協議將不能正常工作當上傳的時候沒有告訴上傳文件的大小。所以設置上傳文件的大小請使用CURLOPT_INFILESIZE_LARGE

/* in this example, file_size must be an curl_off_t variable */
curl_easy_setopt(easyhandle, CURLOPT_INFILESIZE_LARGE, file_size);

當你調用curl_easy_perform()的時候，libcurl會執行所有的必要動作，當開始上傳的時候，它會調用我的回調函數。程序會盡可能多，盡可能快的的上傳數據。回調函數返回寫入緩沖區的數據的大小。返回0的時候就表示上傳結束了。

許多協議要求用戶名和密碼才能下載或者上傳你所選擇的數據。libcurl提供了指定的幾種方法。

許多協議都支持用戶名和密碼包含在指定的URL里。libcurl會檢測並相應的使用它們。可以按照這樣的格式寫

如果你的用戶名和密碼需要一些奇特的字符，你應該使用URLd編碼，像%XX，其中ＸＸ是兩位十六進制的數字。

libcurl同事也提供了一個設置各種類型密碼的選項。設置CURLOPT_USERPWD 選項如下

在某些情況下可能會多次用到用戶名和密碼，可以使用代碼來驗證身份。libcurl提供一個CURLOPT_PROXYUSERPWD選項來實現這種功能,跟CURLOPT_USERPWD 選項很類似

先前的章節我們顯示了如何為需要驗證的URL設置用戶和密碼。當我們使用HTTP協議的時候，客戶端有許多不同的向服務器發送身份驗證。最基本的HTTP認證為Basic認證，它發送base64編碼的明文用戶和密碼，這不安全。如今，libcrul支持使用Basic, Digest, NTLM, Negotiate, GSS-Negotiate and SPNEGO等方式的認證，你可以設置CURLOPT_HTTPAUTH 告訴libcurl使用那種認證。

你可以組合多種認證方式，libcurl會以合理的方式處理 curl_easy_setopt(easyhandle, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST|CURLAUTH_BASIC);

為了方便起見，你還可以使用CURLAUTH_ANY，它允許libcurl使用任何想要的方法。

HTML最簡單的也是最常見的POST是使用<form>這個標簽來實現的。我們提供了一個指向數據段指針，然后告訴licurl把它發送到遠程站點：

char *data=”name=daniel&project=curl”;
curl_easy_setopt(easyhandle, CURLOPT_POSTFIELDS, data);
curl_easy_setopt(easyhandle, CURLOPT_URL, ”http://posthere.com/”);

是不是很簡單。當你設置了CURLOPT_POSTFIELDS選項，它會自動切換句柄來POST接下的請求。

如果你想發送二進制的數據，需要設置一下數據頭，用來知名數據的類型和數據的大小。如下

struct curl_slist *headers=NULL;
headers = curl_slist_append(headers, ”Content-Type: text/xml”);

/* post binary data */
curl_easy_setopt(easyhandle, CURLOPT_POSTFIELDS, binaryptr);

/* set the size of the postfields data */
curl_easy_setopt(easyhandle, CURLOPT_POSTFIELDSIZE, 23L);

/* pass our list of custom made headers */
curl_easy_setopt(easyhandle, CURLOPT_HTTPHEADER, headers);

還有一種是multi-part 表單提交,這被認為是一種更好的方法提交二進制的數據。libcrul同樣也支持這種方法。下面是例子:

struct curl_httppost *post=NULL;
struct curl_httppost *last=NULL;
curl_formadd(&post, &last,   CURLFORM_COPYNAME, ”name”,   CURLFORM_COPYCONTENTS, ”daniel”, CURLFORM_END);
curl_formadd(&post, &last,   CURLFORM_COPYNAME, ”project”,   CURLFORM_COPYCONTENTS, ”curl”, CURLFORM_END);
curl_formadd(&post, &last,   CURLFORM_COPYNAME, ”logotype-image”,   CURLFORM_FILECONTENT, ”curl.png”,
CURLFORM_END);

struct curl_slist *headers=NULL;
headers = curl_slist_append(headers, ”Content-Type: text/xml”);

curl_formadd(&post, &last, CURLFORM_COPYNAME, ”logotype-image”, CURLFORM_FILECONTENT, ”curl.xml”,
CURLFORM_CONTENTHEADER, headers, CURLFORM_END);

curl_formfree(post);
/* free post */
curl_slist_free_all(headers);
/* free custom header list */

所有對簡單接口句柄都是”粘的”，這些屬性會一直保持不變除非你在調用 curl_easy_perform之前改過。通過將CURLOPT_HTTPGET設為1可以使簡單接口句柄回到最原始的狀態：

只設置CURLOPT_POSTFIELDS 的只為”"或者NULL是不會停止libcurl做POST請求的，這只會做提交空數據的POST。

通過將CURLOPT_NOPROCESS設置為0開啟進度支持。該選項默認值為1。對大多數應用程序，我們需要提供一個進度顯示回調。libcurl會不定期的將當前傳輸的進度通過回調函數告訴你的程序。

//回調函數原型
int progress_callback(void *clientp, double dltotal,
double dlnow, double ultotal, double ulnow);

/*通過CURLOPT_PROGRESSFUNCTION注冊該回調函數。
參數clientp是一個用戶自定義指針，應用程序通過CURLOPT_PROCESSDATA
屬性將該自定義指定傳遞給libcurl。libcurl對該參數不作任何處理，
只是簡單將其傳遞給回調函數。*/

只有一件需要特別注意的是回調函數不能使類的非靜態成員函數。如

class AClass
{
static size_t write_data(void *ptr, size_t size, size_t nmemb,
void *ourpointer)
{
/* do what you want with the data */
}
}

每次執行完curl_easy_perform，licurl會繼續保持與服務器的連接。接下來的請求可以使用這個連接而不必創建新的連接（如果目標主機是同一個的話）。這樣可以減少網絡開銷。即使連接被釋放了，libcurl也會緩存這些連接的會話信息，這樣下次再連接到目標主機上時，就可以使用這些信息，從而減少重新連接所需的時間。

FTP連接可能會被保存較長的時間。因為客戶端要與FTP服務器進行頻繁的命令交互。對於有訪問人數上限的FTP服務器，保持一個長連接，可以使你不需要排除等待，就直接可以與FTP服務器通信。

在今后的libcurl版本中，還會添加一些特性來提高數據通信的效率。每個簡單接口句柄都會保存最近使用的幾個連接，以備重用。默認是5個。可以通過CURLOPT_MAXCONNECTS屬性來設置保存連接的數量。

如果你不想重用連接，將CURLOPT_FRESH_CONNECT屬性設置為1。這樣每次提交請求時，libcurl都會先關閉以前創建的連接，然后重新創建一個新的連接。也可以將CURLOPT_FORBID_REUSE設置為1，這樣每次執行完請求，連接就會馬上關閉。

當使用libcurl發送http請求時，它會自動添加一些http頭。我們可以通過CURLOPT_HTTPHEADER屬性手動替換、添加或刪除相應的HTTP消息頭。

例外：以POST的方式向HTTP服務器提交請求時，libcurl會設置該消息頭為”100-continue”，它要求服務器在正式處理該請求之前，返回一個”OK”消息。如果POST的數據很小，libcurl可能不會設置該消息頭。

當前越來越多的協議都構建在HTTP協議之上（如：soap），這主要歸功於HTTP的可靠性，以及被廣泛使用的代理支持（可以穿透大部分防火牆）。這些協議的使用方式與傳統HTTP可能有很大的不同。對此，libcurl作了很好的支持。

cookie是一個鍵值對的集合，HTTP服務器發給客戶端的cookie，客戶端提交請求的時候，也會將cookie發送到服務器。服務器可以根據cookie來跟蹤用戶的會話信息。cookie有過期時間，超時后cookie就會失效。cookie有域名和路徑限制，cookie只能發給指定域名和路徑的HTTP服務器。

在libcurl中，可以通過CURLOPT_COOKIE屬性來設置發往服務器的cookie：

在實在的應用場景中，你可能需要保存服務器發送給你的cookie，並在接下來的請求中，把這些cookie一並發往服務器。所以，可以把上次從服務器收到的所有響應頭信息保存到文本文件中，當下次需要向服務器發送請求時，通過CURLOPT_COOKIEFILE屬性告訴libcurl從該文件中讀取cookie信息。設置CURLOPT_COOKIEFILE屬性意味着激活libcurl的cookie parser。在cookie parser被激活之前，libcurl忽略所以之前接收到的cookie信息。cookie parser被激活之后，cookie信息將被保存內存中，在接下來的請求中，libcurl會自動將這些cookie信息添加到消息頭里，你的應用程序不需要做任何事件。大多數情況下，這已經足夠了。需要注意的是，通過CURLOPT_COOKIEFILE屬性來激活cookie parser，給CURLOPT_COOKIEFILE屬性設置的一個保存cookie信息的文本文件路徑，可能並不需要在磁盤上物理存在。如果你需要使用NetScape或者FireFox瀏覽器的cookie文件，你只要用這些瀏覽器的cookie文件的路徑來初始化CURLOPT_COOKIEFILE屬性，libcurl會自動分析cookie文件，並在接下來的請求過程中使用這些cookie信息。 libcurl甚至能夠把接收到的cookie信息保存成能被Netscape/Mozilla的瀏覽器所識別的cookie文件。通過把這些稱為cookie-jar。通過設置CURLOPT_COOKIEJAR選項，在調用curl_easy_cleanup釋放easy handle的時候，所有的這些cookie信息都會保存到cookie-jar文件中。這就使得cookie信息能在不同的easy handle甚至在瀏覽器之間實現共享。

curl使用筆記 | 大魚兒@Live - Google Chrome (2013/5/22 15:34:11)

CURLOPT_HEADER：設為1，則在返回的內容里包含http header；

CURLOPT_FOLLOWLOCATION：設為0，則不會自動301，302跳轉；

*CURLOPT_INFILESIZE: 當你上傳一個文件到遠程站點，這個選項告訴PHP你上傳文件的大小。

*CURLOPT_VERBOSE: 如果你想CURL報告每一件意外的事情，設置這個選項為一個非零值。

*CURLOPT_HEADER: 如果你想把一個頭包含在輸出中，設置這個選項為一個非零值。

*CURLOPT_NOPROGRESS: 如果你不會PHP為CURL傳輸顯示一個進程條，設置這個選項為一個非零值。

注意：PHP自動設置這個選項為非零值，你應該僅僅為了調試的目的來改變這個選項。

*CURLOPT_NOBODY: 如果你不想在輸出中包含body部分，設置這個選項為一個非零值。

*CURLOPT_FAILONERROR: 如果你想讓PHP在發生錯誤(HTTP代碼返回大於等於300)時，不顯示，設置這個選項為一人非零值。默認行為是返回一個正常頁，忽略代碼。

*CURLOPT_UPLOAD: 如果你想讓PHP為上傳做准備，設置這個選項為一個非零值。

*CURLOPT_POST: 如果你想PHP去做一個正規的HTTP POST，設置這個選項為一個非零值。這個POST是普通的 application/x-www-from-urlencoded 類型，多數被HTML表單使用。

*CURLOPT_FTPLISTONLY: 設置這個選項為非零值，PHP將列出FTP的目錄名列表。

*CURLOPT_FTPAPPEND: 設置這個選項為一個非零值，PHP將應用遠程文件代替覆蓋它。

*CURLOPT_NETRC: 設置這個選項為一個非零值，PHP將在你的 ~./netrc 文件中查找你要建立連接的遠程站點的用戶名及密碼。

*CURLOPT_FOLLOWLOCATION: 設置這個選項為一個非零值(象 “Location: “)的頭，服務器會把它當做HTTP頭的一部分發送(注意這是遞歸的，PHP將發送形如 “Location: “的頭)。

*CURLOPT_PUT: 設置這個選項為一個非零值去用HTTP上傳一個文件。要上傳這個文件必須設置CURLOPT_INFILE和CURLOPT_INFILESIZE選項.

*CURLOPT_MUTE: 設置這個選項為一個非零值，PHP對於CURL函數將完全沉默。

*CURLOPT_TIMEOUT: 設置一個長整形數，作為最大延續多少秒。

*CURLOPT_LOW_SPEED_LIMIT: 設置一個長整形數，控制傳送多少字節。

*CURLOPT_LOW_SPEED_TIME: 設置一個長整形數，控制多少秒傳送CURLOPT_LOW_SPEED_LIMIT規定的字節數。

*CURLOPT_RESUME_FROM: 傳遞一個包含字節偏移地址的長整形參數，(你想轉移到的開始表單)。

*CURLOPT_SSLVERSION: 傳遞一個包含SSL版本的長參數。默認PHP將被它自己努力的確定，在更多的安全中你必須手工設置。

*CURLOPT_TIMECONDITION: 傳遞一個長參數，指定怎么處理CURLOPT_TIMEVALUE參數。你可以設置這個參數為

TIMECOND_IFMODSINCE 或 TIMECOND_ISUNMODSINCE。這僅用於HTTP。

*CURLOPT_TIMEVALUE: 傳遞一個從1970-1-1開始到現在的秒數。這個時間將被CURLOPT_TIMEVALUE選項作為指定值使用，或被默認

TIMECOND_IFMODSINCE使用。

下列選項的值將被作為字符串：

*CURLOPT_URL: 這是你想用PHP取回的URL地址。你也可以在用curl_init()函數初始化時設置這個選項。

*CURLOPT_USERPWD: 傳遞一個形如[username]:[password]風格的字符串,作用PHP去連接。

*CURLOPT_PROXYUSERPWD: 傳遞一個形如[username]:[password] 格式的字符串去連接HTTP代理。

*CURLOPT_RANGE: 傳遞一個你想指定的范圍。它應該是”X-Y”格式，X或Y是被除外的。HTTP傳送同樣支持幾個間隔，用逗句來分隔(X-Y,N-M)。

*CURLOPT_POSTFIELDS: 傳遞一個作為HTTP “POST”操作的所有數據的字符串。

*CURLOPT_REFERER: 在HTTP請求中包含一個”referer”頭的字符串。

*CURLOPT_USERAGENT: 在HTTP請求中包含一個”user-agent”頭的字符串。

*CURLOPT_FTPPORT: 傳遞一個包含被ftp “POST”指令使用的IP地址。這個POST指令告訴遠程服務器去連接我們指定的IP地址。這個字符串可以是一個IP地址，一個主機名，一個網絡界面名(在UNIX下)，或是‘-’(使用系統默認IP地址)。

*CURLOPT_COOKIE: 傳遞一個包含HTTP cookie的頭連接。

*CURLOPT_SSLCERT: 傳遞一個包含PEM格式證書的字符串。

*CURLOPT_SSLCERTPASSWD: 傳遞一個包含使用CURLOPT_SSLCERT證書必需的密碼。

*CURLOPT_COOKIEFILE: 傳遞一個包含cookie數據的文件的名字的字符串。這個cookie文件可以是Netscape格式，或是堆存在文件中的HTTP風格的頭。

*CURLOPT_CUSTOMREQUEST: 當進行HTTP請求時，傳遞一個字符被GET或HEAD使用。為進行DELETE或其它操作是有益的，更Pass a string to be used instead of GET or HEAD when doing an HTTP request. This is useful for doing or another, more obscure, HTTP request.

注意: 在確認你的服務器支持命令先不要去這樣做。

下列的選項要求一個文件描述(通過使用fopen()函數獲得)：

*CURLOPT_FILE: 這個文件將是你放置傳送的輸出文件，默認是STDOUT.

*CURLOPT_INFILE: 這個文件是你傳送過來的輸入文件。

*CURLOPT_WRITEHEADER: 這個文件寫有你輸出的頭部分。

*CURLOPT_STDERR: 這個文件寫有錯誤而不是stderr。

libcurl 是一個很不錯的庫，支持http，ftp等很多的協議。使用庫最大的心得就是，不仔細看文檔，僅僅看着例子就寫程序，是一件危險的事情。我的程序崩潰了，我懷疑是自己代碼寫的問題，后來發現是庫沒用對。不仔細看文檔（有時候文檔本身也比較差勁，這時除了看仔細外，還要多動腦子，考慮它是怎么實現的），后果很嚴重。不加思索的使用別人的庫或者代碼，有時候很愜意，但是出問題時，卻是寢食難安的。

1. CURLcode curl_global_init(long flags); 在多線程應用中，需要在主線程中調用這個函數。這個函數設置libcurl所需的環境。通常情況，如果不顯式的調用它，第一次調用curl_easy_init()時，curl_easy_init 會調用 curl_global_init，在單線程環境下，這不是問題。但是多線程下就不行了，因為curl_global_init不是線程安全的。在多個線程中調用curl_easy_int，然后如果兩個線程同時發現curl_global_init還沒有被調用，同時調用curl_global_init，悲劇就發生了。這種情況發生的概率很小，但可能性是存在的。

2. libcurl 有個很好的特性，它甚至可以控制域名解析的超時。但是在默認情況下，它是使用alarm + siglongjmp 實現的。用alarm在多線程下做超時，本身就幾乎不可能。如果只是使用alarm，並不會導致程序崩潰，但是，再加上siglongjmp，就要命了（程序崩潰的很可怕，core中幾乎看不出有用信息），因為其需要一個sigjmp_buf型的全局變量，多線程修改它。（通常情況下，可以每個線程一個 sigjmp_buf 型的變量，這種情況下，多線程中使用 siglongjmp 是沒有問題的，但是libcurl只有一個全局變量，所有的線程都會用）。

具體是類似 curl_easy_setopt(curl, CURLOPT_TIMEOUT, 30L) 的超時設置，導致alarm的使用（估計發生在域名解析階段），如前所述，這在多線程中是不行的。解決方式是禁用掉alarm這種超時， curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1L)。

這樣，多線程中使用超時就安全了。但是域名解析就沒了超時機制，碰到很慢的域名解析，也很麻煩。文檔的建議是 Consider building libcurl with c-ares support to enable asynchronous DNS lookups, which enables nice timeouts for name resolves without signals. c-ares 是異步的 DNS 解決方案。

來源： <http://gcoder.blogbus.com/logs/54871550.html>

curl_slist_append() 函數聲明如下：

1 2	`#include <curl/curl.h>` `struct` `curl_slist curl_slist_append(` `struct` `curl_slist list,` `const` `char` `* string );`

該函數將一個字符串追加到 slist 鏈表中。第 1 個參數是 struct_slist 類型鏈表；第 2 個參數是要增加到鏈表節點結構中的字符串。函數完成后，返回指向該鏈表的指針。

struct curl_slist 的類型定義在 curl.h 中：

1

2

3

4

5

 
                 /* linked-list structure for the CURLOPT_QUOTE option (and other) */ 
                
                 struct 
                 curl_slist { 
                
                 char 
                 *data; 
                
                 struct 
                 curl_slist *next; 
                
                 };

使用了該函數，在工作完成后應該使用 curl_slist_free_all() 對其鏈表進行釋放。

來源： <http://www.groad.net/bbs/read.php?tid-3985.html>

curl/types.h: No such file or directory問題的解決

發布時間: 2012-08-27 09:49 來源: blog.csdn.net

在程序中用到了libcurl，編譯時出現

curl/types.h: No such file or directory錯誤

查找到http://projects.springlobby.info/issues/1575中提到了這個問題

This is a problem on archlinux which just got curl 7.21.7.

curl devs removed curl/types.h and put its content in curl/curl.h.

意思是在新版中把curl/types.h合並到了curl/curl.h中

我的解決方法是在

[plain] view plain copy

cd /usr/include/curl/
sudo ln -s curl.h types.h

再編譯，問題沒有了。

來源： <http://www.eifr.com/article.php?id=1800>

-M/--manual	顯示全手動
-n/--netrc	從netrc文件中讀取用戶名和密碼
--netrc-optional	使用 .netrc 或者 URL來覆蓋-n
--ntlm	使用 HTTP NTLM 身份驗證
-N/--no-buffer	禁用緩沖輸出
-o/--output	把輸出寫到該文件中
-O/--remote-name	把輸出寫到該文件中，保留遠程文件的文件名
-p/--proxytunnel	使用HTTP代理
--proxy-anyauth	選擇任一代理身份驗證方法
--proxy-basic	在代理上使用基本身份驗證
--proxy-digest	在代理上使用數字身份驗證
--proxy-ntlm	在代理上使用ntlm身份驗證
-P/--ftp-port <address>	使用端口地址，而不是使用PASV
-Q/--quote <cmd>	文件傳輸前，發送命令到服務器
-r/--range <range>	檢索來自HTTP/1.1或FTP服務器字節范圍
--range-file	讀取（SSL）的隨機文件
-R/--remote-time	在本地生成文件時，保留遠程文件時間
--retry <num>	傳輸出現問題時，重試的次數
--retry-delay <seconds>	傳輸出現問題時，設置重試間隔時間
--retry-max-time <seconds>	傳輸出現問題時，設置最大重試時間
-s/--silent	靜音模式。不輸出任何東西
-S/--show-error	顯示錯誤
--socks4 <host[:port]>	用socks4代理給定主機和端口
--socks5 <host[:port]>	用socks5代理給定主機和端口
-t/--telnet-option <OPT=val>	Telnet選項設置
--trace <file>	對指定文件進行debug
--trace-ascii <file> Like	跟蹤但沒有hex輸出
--trace-time	跟蹤/詳細輸出時，添加時間戳
-T/--upload-file <file>	上傳文件
--url <URL>	Spet URL to work with
-u/--user <user[:password]>	設置服務器的用戶和密碼
-U/--proxy-user <user[:password]>	設置代理用戶名和密碼
-V/--version	顯示版本信息
-w/--write-out [format]	什么輸出完成后
-x/--proxy <host[:port]>	在給定的端口上使用HTTP代理
-X/--request <command>	指定什么命令
-y/--speed-time	放棄限速所要的時間。默認為30
-Y/--speed-limit	停止傳輸速度的限制，速度時間'秒
-z/--time-cond	傳送時間設置
-0/--http1.0	使用HTTP 1.0
-1/--tlsv1	使用TLSv1（SSL）
-2/--sslv2	使用SSLv2的（SSL）
-3/--sslv3	使用的SSLv3（SSL）
--3p-quote	like -Q for the source URL for 3rd party transfer
--3p-url	使用url，進行第三方傳送
--3p-user	使用用戶名和密碼，進行第三方傳送
-4/--ipv4	使用IP4
-6/--ipv6	使用IP6
-#/--progress-bar	用進度條顯示當前的傳送狀態

筆記整理--LibCurl開發

LibCurl開發_未了的雨_百度空間 - Google Chrome (2013/7/26 21:11:15)

LibCurl開發

libcurl 使用筆記 - 喜歡初美 - 博客大巴 - Google Chrome (2013/7/26 17:50:53)

libcurl 使用筆記

日期：2009-12-24 | 分類：c & c++

使用 cURL 和 libcurl 通過 Internet 進行對話 - Google Chrome (2013/7/26 16:58:48)

使用 cURL 和 libcurl 通過 Internet 進行對話

cURL 的起源與發展

使用 Python 進行原型化

fatal error: curl/curl.h: No such file or directory | Ubuntu 12.04 from alexsleat.co.uk - Google Chr (2013/7/26 16:49:05)

fatal error: curl/curl.h: No such file or directory | Ubuntu 12.04

curl_easy_getinfo() -- 從 curl 句柄里獲得附加信息|Functions - 曲徑通幽 - Standing on the shoulders of giants - Goo (2013/5/23 17:52:30)

C++ 用libcurl庫進行http通訊網絡編程 - 綠色冰點 - 博客園 - Google Chrome (2013/5/23 16:59:53)

Linux libcurl使用（一）(收藏)_留風的貝殼_百度空間 - Google Chrome (2013/5/23 15:17:01)

Linux libcurl使用（一）(收藏)

【Curl (libcurl) 開發】Cocos2dx之libcurl（curl_easy）的編程教程（幫助手冊）！ | 黑米GameDev街區 - Google Chrome (2013/5/23 14:56:10)

curl使用筆記 | 大魚兒@Live - Google Chrome (2013/5/22 15:34:11)

curl使用筆記

curl/types.h: No such file or directory問題的解決

linux curl命令詳解 - - ITeye技術網站 - Google Chrome (2013/5/22 15:31:00)

linux curl命令詳解

免責聲明！

筆記整理--LibCurl開發

LibCurl開發_未了的雨_百度空間 - Google Chrome (2013/7/26 21:11:15)

LibCurl開發

libcurl 使用筆記 - 喜歡初美 - 博客大巴 - Google Chrome (2013/7/26 17:50:53)

libcurl 使用筆記

日期：2009-12-24 | 分類：c & c++

使用 cURL 和 libcurl 通過 Internet 進行對話 - Google Chrome (2013/7/26 16:58:48)

使用 cURL 和 libcurl 通過 Internet 進行對話

cURL 的起源與發展

使用 Python 進行原型化

fatal error: curl/curl.h: No such file or directory | Ubuntu 12.04 from alexsleat.co.uk - Google Chr (2013/7/26 16:49:05)

fatal error: curl/curl.h: No such file or directory | Ubuntu 12.04

curl_easy_getinfo() -- 從 curl 句柄里獲得附加信息|Functions - 曲徑通幽 - Standing on the shoulders of giants - Goo (2013/5/23 17:52:30)

C++ 用libcurl庫進行http通訊網絡編程 - 綠色冰點 - 博客園 - Google Chrome (2013/5/23 16:59:53)

Linux libcurl使用（一）(收藏)_留風的貝殼_百度空間 - Google Chrome (2013/5/23 15:17:01)

Linux libcurl使用（一）(收藏)

【Curl (libcurl) 開發 】Cocos2dx之libcurl（curl_easy）的編程教程（幫助手冊）！ | 黑米GameDev街區 - Google Chrome (2013/5/23 14:56:10)

curl使用筆記 | 大魚兒@Live - Google Chrome (2013/5/22 15:34:11)

curl/types.h: No such file or directory問題的解決

linux curl命令詳解 - - ITeye技術網站 - Google Chrome (2013/5/22 15:31:00)

linux curl命令詳解

免責聲明！

【Curl (libcurl) 開發】Cocos2dx之libcurl（curl_easy）的編程教程（幫助手冊）！ | 黑米GameDev街區 - Google Chrome (2013/5/23 14:56:10)