libcurl的使用總結（一）

最近的項目中由于要在C++代碼中調用PHP的URL，是以不得不借助libcurl這個庫，由于第一次用，是以很多地方很是糾結，特此寫在這裡，友善給同樣剛入門的朋友指引。

分兩篇介紹，第一篇是理論知識，第二篇是執行個體。快速連結–libcurl的使用總結（一）

一.下載下傳安裝

    1.到http://curl.haxx.se/download.html上下載下傳最新版本，由于公司的機器安裝rpm有依賴關系，是以直接下載下傳了source

    2.編譯。解壓後進入curl的目錄，直接執行 make all 就行。

    3.等待編譯結束後，可以檢視目錄結構。

        curl/include/curl ： 頭檔案目錄 （一般隻要包含curl.h即可）

        curl/lib/.lib/      ： lib檔案目錄（有libcurl.a和libcurl.so，注意，如果這兩個檔案在同一目錄下，-lcurl預設是連結.so滴）

二.函數簡要說明

在基于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程式都要使用它。

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類型的指針.

三.重要函數詳解

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

偏移量。

2）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

    讀本地檔案錯誤