一、LibCurl簡介
LibCurl是免費的客戶端URL傳輸庫，支持FTP,FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, FILE ，LDAP等協議，其主頁是http://curl.haxx.se/。Libcurl具備線程安全、IpV6兼容、易於使用的特點。curl也是Linux下一個非常著名的下載庫，通過這個庫，可以很簡單的實現文件的下載等操作
二、LibCurl編程
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) 重要函數
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，指定你希望開始傳遞的
偏移量。
8. //CURLOPT_SSL_VERIFYPEER禁 用后cURL將終止從服務端進行驗證。
//使用CURLOPT_CAINFO選項設置證書使用CURLOPT_CAPATH選項設置證書目錄 如果
//CURLOPT_SSL_VERIFYPEER(默認值為2)被啟用，CURLOPT_SSL_VERIFYHOST需要被設置成TRUE否則設置為 FALSE。
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
讀本地文件錯誤
三、簡單例子：
#include <curl/curl.h>
#include <stdio.h>
#include <string.h>
CURL *curl;
CURLcode res;
size_t write_data(void *ptr, size_t size, size_t nmemb, void *stream)
{
if (strlen((char *)stream) + strlen((char *)ptr) > 999999) return 0;
strcat(stream, (char *)ptr);
return size*nmemb;
}
char *down_file(char *filename)
{
static char str[10000000];
strcpy(str, “”);
//return “”;
curl_easy_setopt(curl, CURLOPT_URL, filename); //設置下載地址
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);//設置超時時間
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);//設置寫數據的函數
curl_easy_setopt(curl, CURLOPT_WRITEDATA, str);//設置寫數據的變量
res = curl_easy_perform(curl);//執行下載
str[9999999] = ‘\0′;
if(CURLE_OK != res) return NULL;//判斷是否下載成功
return str;
}
int main()
{
char url[200];
curl = curl_easy_init();//對curl進行初始化
char *result;
while(fgets(url, 200, stdin)){
result = down_file(url);
if (result) puts(result);
else puts(“Get Error!”);
printf(“\nPlease Input a url:”);
}
curl_easy_cleanup(curl);//釋放curl資源
return 0;
}
四、安裝使用
編譯源碼
有很多種不同的方式來編譯C語言代碼。這里使用UNIX平台下的編譯方式。即使你使用的是其他的操作系統，你仍然可以通過閱讀本文檔來獲取許多有用的信息。
編譯
你的編譯器必須知道libcurl頭文件的位置。所以在編譯的時候，你要設置頭文件的包含路徑。可以使用curl-config工具來獲取這方面的信息：
$ curl-config –cflags
鏈接
編譯完源碼（這時的源代碼不是指libcurl的源代碼，你是你自己寫的程序代碼）之后，你還必須把目標文件鏈接成單個可執行文件。你要鏈接 libcurl庫，以及libcurl所依賴的其他庫，例如OpenSLL庫。當然可能還需要一些其他的操作系統庫。最后你還要設置一些編譯選項，當然可 以使用curl-config工具簡化操作：
$curl-config –libs
是否使用SSL
定制編譯libcurl。與其他庫不同的是，libcurl可以定制編譯，根據實際需要是否支持某些特性，如是否支持SSL傳輸，像HTTPS和 FTPS。如果決定需要支持SSL，必須在編譯時正確的設置。可以使用’curl-config’來判斷libcurl庫是否支持SSL：
$ curl-config –feature
autoconf宏
當你編寫配置腳本來檢測libcurl及其相應設置時，你可以使用預定義宏。文檔docs/libcurl/libcurl.m4告訴你如何使用這些宏。
跨平台的可移植的代碼
libcurl的開發人員花費很大的努力，使libcurl盡可能在大多數平台上正常運行。
全局初始化
應用程序在使用libcurl之前，必須先初始化libcurl。libcurl只需初始化一次。可以使用以下語句進行初始化：
curl_global_init();
curl_global_init()接收一個參數，告訴libcurl如何初始化。參數CURL_GLOBAL_ALL 會使libcurl初始化所有的子模塊和一些默認的選項，通常這是一個比較好的默認參數值。還有兩個可選值：CURL_GLOBAL_WIN32
只能應用於Windows平台。它告訴libcurl初始化winsock庫。如果winsock庫沒有正確地初始化，應用程序就不能使用socket。在應用程序中，只要初始化一次即可。
CURL_GLOBAL_SSL
如果libcurl在編譯時被設定支持SSL，那么該參數用於初始化相應的SSL庫。同樣，在應用程序中，只要初始化一次即可。
libcurl有默認的保護機制，如果在調用curl_easy_perform時它檢測到還沒有通過curl_global_init進行初始 化，
libcurl會根據當前的運行時環境，自動調用全局初始化函數。但必須清楚的是，讓系統自已初始化不是一個好的選擇。
當應用程序不再使用libcurl的時候，應該調用curl_global_cleanup來釋放相關的資源。
在程序中，應當避免多次調用curl_global_init和curl_global_cleanup。它們只能被調用一次。
五、使用multi-part formposts
Multi-part formposts被認為是提交二進制數據(或大量數據)的更好方法，可以在RFC1867, RFC2388中找到他們的定義。何為Multi-part？其實，就我理解，就是在Post提交的時候，有不同的數據單元，每個單元有自己的名稱與內 容，內容可以是文本的，也可以是二進制的。同時，每個數據單元都可以有自己的消息頭，MIME類型，這些數據單元組成一個鏈表，提交到HTTP服務器。 libcurl提供了方便的api用於支持multi-part formposts。使用curl_formadd函數，可以添加不同的數據數據單元，然后提交到服務器。下面是一個multi-part formposts的例子（更詳細的使用，請參考：http://curl.haxx.se/libcurl/c/curl_formadd.html ）：
int main()
{
curl_global_init(CURL_GLOBAL_WIN32);
CURL *easy_handle = curl_easy_init();
// 使用multi-parts form post
curl_easy_setopt(easy_handle, CURLOPT_URL, http://localhost:2210/Default.aspx);
curl_httppost *post = NULL;
curl_httppost *last = NULL;
// 文本數據
curl_formadd(&post, &last, CURLFORM_COPYNAME, "name", CURLFORM_COPYCONTENTS, "JGood", CURLFORM_END);
curl_formadd(&post, &last, CURLFORM_COPYNAME, "address", CURLFORM_COPYCONTENTS, "HangZhou", CURLFORM_END);
// 文本文件中的數據
curl_formadd(&post, &last, CURLFORM_COPYNAME, "file", CURLFORM_FILECONTENT, "ReadMe.txt", CURLFORM_END);
curl_easy_setopt(easy_handle, CURLOPT_HTTPPOST, post);
curl_easy_perform(easy_handle);
curl_formfree(post);
curl_easy_cleanup(easy_handle);
curl_global_cleanup();
return 0;
}
最后要說明的是，所有在easy handle上設置的屬性都是”sticky”的，什么意思？就是說在easy handle上設置的屬性都將被保存，即使執行完curl_easy_perform之后，這些屬性值仍然存在。通過將CURLOPT_HTTPGET設 為1可以使easy handle回到最原始的狀態：
六、消息頭處理
1.修改消息頭
HTTP協議提供了消息頭，請求消息頭用於告訴服務器如何處理請求；響應消息頭則告訴瀏覽器如何處理接收到的數據。在libcurl中，你可以自由的添加這些消息頭：
struct curl_slist *headers=NULL; /* init to NULL is important */ 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");
2.刪除消息頭
對於一個已經存在的消息頭，設置它的內容為空，libcurl在發送請求時就不會同時提交該消息頭：
headers = curl_slist_append(headers, "Accept:");
七、curl_easy_getinfo
curl_easy_getinfo() 函數原型聲明如下：
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ... );
使用該函數可以在請求求 curl 會話中的相關信息。注意，第 3 個參數必須是一個 long 型，或char型，或curl_slist型，抑或是double型的指針。函數所請求信息只有在函數返回 CURLE_OK 時才會被有效填充，該函數一般用在 perform 函數(如 curl_easy_perform() )之后。
第 2 個參數有眾多選項，每個選項都有其相應的含義：
CURLINFO_SIZE_DOWNLOAD
使用該選項時要求第 3 個參數是個 double 型的指針，這樣在一次傳輸成功后會將本次傳輸所下載的字節數賦值到指針所指向的 double 型變量中。注意，這個字節數只能反映最近一次的下載。
CURLINFO_SPEED_DOWNLOAD
該選項要求傳遞一個 double 型參數指針，用以接收下載的平均速度，這個速度不是即時速度，而是下載完成后的速度，單位是 字節/秒 。
CURLINFO_TOTAL_TIME
該選項要求傳遞一個 double 指針到函數中，double 型變量指示了傳輸的總耗時(單位為秒)，這個總的時間里包括了域名解析，以及 TCP 連接過程中所需要的時間。
CURLINFO_CONTENT_TYPE
該選項獲得 HTTP 中從服務器端收到的頭部中的 Content-Type 信息。
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
我們期望的狀態碼是200，而且HTTP標准也對其它狀態碼做了一些定義。
| 總體范圍 |
已定義類別 |
類別 |
| 100~199 |
100~101 |
信息 |
| 200~299 |
200~206 |
成功 |
| 300~399 |
300~305 |
重定向 |
| 400~499 |
400~415 |
客戶端錯誤 |
| 500~599 |
500~505 |
服務端錯誤 |
原文:http://www.cnblogs.com/jikexianfeng/p/6055024.html
http://blog.csdn.net/followingturing/article/details/7851425
實際示例:
curl_global_init(CURL_GLOBAL_ALL);//初始化所有的可能的調用。
if(!(curl = curl_easy_init()))//curl_easy_init用來初始化一個CURL的指針(有些像返回FILE類型的指針一樣). 相應的在調用結束時要用curl_easy_cleanup函數清理
{
return NULL;
}
//文件上傳時間為60s
if(curl_easy_setopt(curl, CURLOPT_TIMEOUT, 60) != CURLE_OK
|| !(pEventUrl = (EVENT_URL_S *)malloc(sizeof(EVENT_URL_S))))
{
DebugPrintf("set post file time out err!\n");
curl_easy_cleanup(curl);
curl_global_cleanup();
return NULL;
}
//CURLOPT_SSL_VERIFYPEER禁 用后cURL將終止從服務端進行驗證。
//使用CURLOPT_CAINFO選項設置證書使用CURLOPT_CAPATH選項設置證書目錄 如果
//CURLOPT_SSL_VERIFYPEER(默認值為2)被啟用，CURLOPT_SSL_VERIFYHOST需要被設置成TRUE否則設置為 FALSE。
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);
curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_MD5,
CURLFORM_COPYCONTENTS, pEventMsg->pMD5, CURLFORM_END);
curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_TOKEN,
CURLFORM_COPYCONTENTS, token, CURLFORM_END);
curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_WIDTH,
CURLFORM_COPYCONTENTS, pEventMsg->pWidth , CURLFORM_END);
curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_HEIGH,
CURLFORM_COPYCONTENTS, pEventMsg->pHeight, CURLFORM_END);
curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_PATH,
CURLFORM_FILE, pEventMsg->pFilePath, CURLFORM_END);
curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_THUMBNAIL,
CURLFORM_COPYCONTENTS, "1", CURLFORM_END);
headerlist = curl_slist_append(headerlist, "Expect:"); //對於一個已經存在的消息頭，設置它的內容為空，libcurl在發送請求時就不會同時提交該消息頭：
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headerlist);
curl_easy_setopt(curl, CURLOPT_URL, gpCC->ccArg.pUploadUrl);
curl_easy_setopt(curl, CURLOPT_HTTPPOST, formpost);
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, &SaveHttpResponse); // 設置回調函數
curl_easy_setopt(curl, CURLOPT_WRITEDATA, resMsg); // 設置保存數據區
//DebugPrintf("EventPostFile, token: %s\n", token);
//DebugPrintf("EventPostFile, md5: %s\n", pEventMsg->pMD5);
while(count < 3)
{
resMsg[0] = '\0';
//DebugPrintf("upload start: %lld\n", GetSysRunSec());
res = curl_easy_perform(curl);
//DebugPrintf("upload end: %lld\n", GetSysRunSec());
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &httpRetCode);//取得response code
DebugPrintf("res: %d, httpRetCode: %d, count: %d\n", res, httpRetCode, count + 1);
if(resMsg[0] != '\0')
{
DebugPrintf("Server response: %s\n", resMsg);
}
if(CURLE_OK == res)
{
if(httpRetCode == 200)//我們期望的狀態碼是200，而且HTTP標准也對其它狀態碼做了一些定義。
{//200表示成功
if((pHttpResBody = json_tokener_parse(resMsg))
&& (pResCode = json_object_object_get(pHttpResBody, K_RESULT_CODE))
&& (strcasecmp(json_object_get_string(pResCode), V_RC_SUCCESS) == 0))
{
break;
}
else
{
FREE_JSON_OBJ(pHttpResBody);
}
}
}
else
{
DebugPrintf("post file err: %d, rc: %d\n", count + 1, res);
}
++count;
}
curl_easy_cleanup(curl);
curl_slist_free_all (headerlist);
curl_formfree(formpost);
curl_global_cleanup();
附錄：
url選項列表進行了詳細的分析介紹，需要的朋友參考下
第一類：
對於下面的這些option的可選參數，value應該被設置一個bool類型的值：
選項
可選value值
備注
CURLOPT_AUTOREFERER
當根據Location:重定向時，自動設置header中的Referer:信息。
CURLOPT_BINARYTRANSFER
在啟用CURLOPT_RETURNTRANSFER的時候，返回原生的（Raw）輸出。
CURLOPT_COOKIESESSION
啟用時curl會僅僅傳遞一個session cookie，忽略其他的cookie，默認狀況下cURL會將所有的cookie返回給服務端。session cookie是指那些用來判斷服務器端的session是否有效而存在的cookie。
CURLOPT_CRLF
啟用時將Unix的換行符轉換成回車換行符。
CURLOPT_DNS_USE_GLOBAL_CACHE
啟用時會啟用一個全局的DNS緩存，此項為線程安全的，並且默認啟用。
CURLOPT_FAILONERROR
顯示HTTP狀態碼，默認行為是忽略編號小於等於400的HTTP信息。
CURLOPT_FILETIME
啟用時會嘗試修改遠程文檔中的信息。結果信息會通過 curl_getinfo()函數的CURLINFO_FILETIME選項返回。curl_getinfo().
CURLOPT_FOLLOWLOCATION
啟用時會將服務器服務器返回的"Location: "放在header中遞歸的返回給服務器，使用CURLOPT_MAXREDIRS可以限定遞歸返回的數量。
CURLOPT_FORBID_REUSE
在完成交互以后強迫斷開連接，不能重用。
CURLOPT_FRESH_CONNECT
強制獲取一個新的連接，替代緩存中的連接。
CURLOPT_FTP_USE_EPRT
啟用時當FTP下載時，使用EPRT (或 LPRT)命令。設置為FALSE時禁用EPRT和LPRT，使用PORT命令 only.
CURLOPT_FTP_USE_EPSV
啟用時，在FTP傳輸過程中回復到PASV模式前首先嘗試EPSV命令。設置為FALSE時禁用EPSV命令。
CURLOPT_FTPAPPEND
啟用時追加寫入文件而不是覆蓋它。
CURLOPT_FTPASCII
CURLOPT_TRANSFERTEXT的別名。
CURLOPT_FTPLISTONLY
啟用時只列出FTP目錄的名字。
CURLOPT_HEADER
啟用時會將頭文件的信息作為數據流輸出。
CURLINFO_HEADER_OUT
啟用時追蹤句柄的請求字符串。
從 PHP 5.1.3 開始可用。CURLINFO_前綴是故意的(intentional)。
CURLOPT_HTTPGET
啟用時會設置HTTP的method為GET，因為GET是默認是，所以只在被修改的情況下使用。
CURLOPT_HTTPPROXYTUNNEL
啟用時會通過HTTP代理來傳輸。
CURLOPT_MUTE
啟用時將cURL函數中所有修改過的參數恢復默認值。
CURLOPT_NETRC
在連接建立以后，訪問~/.netrc文件獲取用戶名和密碼信息連接遠程站點。
CURLOPT_NOBODY
啟用時將不對HTML中的BODY部分進行輸出。
CURLOPT_NOPROGRESS
啟用時關閉curl傳輸的進度條，此項的默認設置為啟用。
Note:
PHP自動地設置這個選項為TRUE，這個選項僅僅應當在以調試為目的時被改變。
CURLOPT_NOSIGNAL
啟用時忽略所有的curl傳遞給php進行的信號。在SAPI多線程傳輸時此項被默認啟用。
cURL 7.10時被加入。
CURLOPT_POST
啟用時會發送一個常規的POST請求，類型為：application/x-www-form-urlencoded，就像表單提交的一樣。
CURLOPT_PUT
啟用時允許HTTP發送文件，必須同時設置CURLOPT_INFILE和CURLOPT_INFILESIZE。
CURLOPT_RETURNTRANSFER
將 curl_exec()獲取的信息以文件流的形式返回，而不是直接輸出。
CURLOPT_SSL_VERIFYPEER
禁 用后cURL將終止從服務端進行驗證。使用CURLOPT_CAINFO選項設置證書使用CURLOPT_CAPATH選項設置證書目錄 如果CURLOPT_SSL_VERIFYPEER(默認值為2)被啟用，CURLOPT_SSL_VERIFYHOST需要被設置成TRUE否則設置為 FALSE。
自cURL 7.10開始默認為TRUE。從cURL 7.10開始默認綁定安裝。
CURLOPT_TRANSFERTEXT
啟用后對FTP傳輸使用ASCII模式。對於LDAP，它檢索純文本信息而非HTML。在Windows系統上，系統不會把STDOUT設置成binary模式。
CURLOPT_UNRESTRICTED_AUTH
在使用CURLOPT_FOLLOWLOCATION產生的header中的多個locations中持續追加用戶名和密碼信息，即使域名已發生改變。
CURLOPT_UPLOAD
啟用后允許文件上傳。
CURLOPT_VERBOSE
啟用時會匯報所有的信息，存放在STDERR或指定的CURLOPT_STDERR中。
第二類：
對於下面的這些option的可選參數，value應該被設置一個integer類型的值：
選項
可選value值
備注
CURLOPT_BUFFERSIZE
每次獲取的數據中讀入緩存的大小，但是不保證這個值每次都會被填滿。
在cURL 7.10中被加入。
CURLOPT_CLOSEPOLICY
不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST，還存在另外三個CURLCLOSEPOLICY_，但是cURL暫時還不支持。
CURLOPT_CONNECTTIMEOUT
在發起連接前等待的時間，如果設置為0，則無限等待。
CURLOPT_CONNECTTIMEOUT_MS
嘗試連接等待的時間，以毫秒為單位。如果設置為0，則無限等待。
在cURL 7.16.2中被加入。從PHP 5.2.3開始可用。
CURLOPT_DNS_CACHE_TIMEOUT
設置在內存中保存DNS信息的時間，默認為120秒。
CURLOPT_FTPSSLAUTH
FTP驗證方式：CURLFTPAUTH_SSL (首先嘗試SSL)，CURLFTPAUTH_TLS (首先嘗試TLS)或CURLFTPAUTH_DEFAULT (讓cURL自動決定)。
在cURL 7.12.2中被加入。
CURLOPT_HTTP_VERSION
CURL_HTTP_VERSION_NONE (默認值，讓cURL自己判斷使用哪個版本)，CURL_HTTP_VERSION_1_0 (強制使用 HTTP/1.0)或CURL_HTTP_VERSION_1_1 (強制使用 HTTP/1.1)。
CURLOPT_HTTPAUTH
使用的HTTP驗證方法，可選的值有：CURLAUTH_BASIC、CURLAUTH_DIGEST、CURLAUTH_GSSNEGOTIATE、CURLAUTH_NTLM、CURLAUTH_ANY和CURLAUTH_ANYSAFE。
可以使用|位域(或)操作符分隔多個值，cURL讓服務器選擇一個支持最好的值。
CURLAUTH_ANY等價於CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM.
CURLAUTH_ANYSAFE等價於CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM.
CURLOPT_INFILESIZE
設定上傳文件的大小限制，字節(byte)為單位。
CURLOPT_LOW_SPEED_LIMIT
當傳輸速度小於CURLOPT_LOW_SPEED_LIMIT時(bytes/sec)，PHP會根據CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。
CURLOPT_LOW_SPEED_TIME
當傳輸速度小於CURLOPT_LOW_SPEED_LIMIT時(bytes/sec)，PHP會根據CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。
CURLOPT_MAXCONNECTS
允許的最大連接數量，超過是會通過CURLOPT_CLOSEPOLICY決定應該停止哪些連接。
CURLOPT_MAXREDIRS
指定最多的HTTP重定向的數量，這個選項是和CURLOPT_FOLLOWLOCATION一起使用的。
CURLOPT_PORT
用來指定連接端口。（可選項）
CURLOPT_PROTOCOLS
CURLPROTO_* 的位域指。如果被啟用，位域值會限定libcurl在傳輸過程中有哪些可使用的協議。這將允許你在編譯libcurl時支持眾多協議，但是限制只是用它們 中被允許使用的一個子集。默認libcurl將會使用全部它支持的協議。參見CURLOPT_REDIR_PROTOCOLS.
可用的協議選項 為：CURLPROTO_HTTP、CURLPROTO_HTTPS、CURLPROTO_FTP、CURLPROTO_FTPS、 CURLPROTO_SCP、CURLPROTO_SFTP、CURLPROTO_TELNET、CURLPROTO_LDAP、 CURLPROTO_LDAPS、CURLPROTO_DICT、CURLPROTO_FILE、CURLPROTO_TFTP、 CURLPROTO_ALL
在cURL 7.19.4中被加入。
CURLOPT_PROXYAUTH
HTTP代理連接的驗證方式。使用在CURLOPT_HTTPAUTH中的位域標志來設置相應選項。對於代理驗證只有CURLAUTH_BASIC和CURLAUTH_NTLM當前被支持。
在cURL 7.10.7中被加入。
CURLOPT_PROXYPORT
代理服務器的端口。端口也可以在CURLOPT_PROXY中進行設置。
CURLOPT_PROXYTYPE
不是CURLPROXY_HTTP (默認值) 就是CURLPROXY_SOCKS5。
在cURL 7.10中被加入。
CURLOPT_REDIR_PROTOCOLS
CURLPROTO_* 中的位域值。如果被啟用，位域值將會限制傳輸線程在CURLOPT_FOLLOWLOCATION開啟時跟隨某個重定向時可使用的協議。這將使你對重定向 時限制傳輸線程使用被允許的協議子集默認libcurl將會允許除FILE和SCP之外的全部協議。這個和7.19.4預發布版本種無條件地跟隨所有支持 的協議有一些不同。關於協議常量，請參照CURLOPT_PROTOCOLS。
在cURL 7.19.4中被加入。
CURLOPT_RESUME_FROM
在恢復傳輸時傳遞一個字節偏移量（用來斷點續傳）。
CURLOPT_SSL_VERIFYHOST
1 檢查服務器SSL證書中是否存在一個公用名(common name)。譯者注：公用名(Common Name)一般來講就是填寫你將要申請SSL證書的域名 (domain)或子域名(sub domain)。2 檢查公用名是否存在，並且是否與提供的主機名匹配。
CURLOPT_SSLVERSION
使用的SSL版本(2 或 3)。默認情況下PHP會自己檢測這個值，盡管有些情況下需要手動地進行設置。
CURLOPT_TIMECONDITION
如 果在CURLOPT_TIMEVALUE指定的某個時間以后被編輯過，則使用CURL_TIMECOND_IFMODSINCE返回頁面，如果沒有被修改 過，並且CURLOPT_HEADER為true，則返回一個"304 Not Modified"的header， CURLOPT_HEADER為false，則使用CURL_TIMECOND_IFUNMODSINCE，默認值為 CURL_TIMECOND_IFUNMODSINCE。
CURLOPT_TIMEOUT
設置cURL允許執行的最長秒數。
CURLOPT_TIMEOUT_MS
設置cURL允許執行的最長毫秒數。
在cURL 7.16.2中被加入。從PHP 5.2.3起可使用。
CURLOPT_TIMEVALUE
設置一個CURLOPT_TIMECONDITION使用的時間戳，在默認狀態下使用的是CURL_TIMECOND_IFMODSINCE。
第三類：
對於下面的這些option的可選參數，value應該被設置一個string類型的值：
選項
可選value值
備注
CURLOPT_CAINFO
一個保存着1個或多個用來讓服務端驗證的證書的文件名。這個參數僅僅在和CURLOPT_SSL_VERIFYPEER一起使用時才有意義。 .
CURLOPT_CAPATH
一個保存着多個CA證書的目錄。這個選項是和CURLOPT_SSL_VERIFYPEER一起使用的。
CURLOPT_COOKIE
設定HTTP請求中"Cookie: "部分的內容。多個cookie用分號分隔，分號后帶一個空格(例如， "fruit=apple; colour=red")。
CURLOPT_COOKIEFILE
包含cookie數據的文件名，cookie文件的格式可以是Netscape格式，或者只是純HTTP頭部信息存入文件。
CURLOPT_COOKIEJAR
連接結束后保存cookie信息的文件。
CURLOPT_CUSTOMREQUEST
使 用一個自定義的請求信息來代替"GET"或"HEAD"作為HTTP請求。這對於執行"DELETE" 或者其他更隱蔽的HTTP請求。有效值如"GET"，"POST"，"CONNECT"等等。也就是說，不要在這里輸入整個HTTP請求。例如輸 入"GET /index.html HTTP/1.0rnrn"是不正確的。
Note:
在確定服務器支持這個自定義請求的方法前不要使用。
CURLOPT_EGDSOCKET
類似CURLOPT_RANDOM_FILE，除了一個Entropy Gathering Daemon套接字。
CURLOPT_ENCODING
HTTP請求頭中"Accept-Encoding: "的值。支持的編碼有"identity"，"deflate"和"gzip"。如果為空字符串""，請求頭會發送所有支持的編碼類型。
在cURL 7.10中被加入。
CURLOPT_FTPPORT
這個值將被用來獲取供FTP"POST"指令所需要的IP地址。"POST"指令告訴遠程服務器連接到我們指定的IP地址。這個字符串可以是純文本的IP地址、主機名、一個網絡接口名（UNIX下）或者只是一個'-'來使用默認的IP地址。
CURLOPT_INTERFACE
網絡發送接口名，可以是一個接口名、IP地址或者是一個主機名。
CURLOPT_KRB4LEVEL
KRB4 (Kerberos 4) 安全級別。下面的任何值都是有效的(從低到高的順序)："clear"、"safe"、"confidential"、"private".。如果字符串 和這些都不匹配，將使用"private"。這個選項設置為NULL時將禁用KRB4 安全認證。目前KRB4 安全認證只能用於FTP傳輸。
CURLOPT_POSTFIELDS
全 部數據使用HTTP協議中的"POST"操作來發送。要發送文件，在文件名前面加上@前綴並使用完整路徑。這個參數可以通過urlencoded后的字符 串類似'para1=val1¶2=val2&...'或使用一個以字段名為鍵值，字段數據為值的數組。如果value是一個數 組，Content-Type頭將會被設置成multipart/form-data。
CURLOPT_PROXY
HTTP代理通道。
CURLOPT_PROXYUSERPWD
一個用來連接到代理的"[username]:[password]"格式的字符串。
CURLOPT_RANDOM_FILE
一個被用來生成SSL隨機數種子的文件名。
CURLOPT_RANGE
以"X-Y"的形式，其中X和Y都是可選項獲取數據的范圍，以字節計。HTTP傳輸線程也支持幾個這樣的重復項中間用逗號分隔如"X-Y,N-M"。
CURLOPT_REFERER
在HTTP請求頭中"Referer: "的內容。
CURLOPT_SSL_CIPHER_LIST
一個SSL的加密算法列表。例如RC4-SHA和TLSv1都是可用的加密列表。
CURLOPT_SSLCERT
一個包含PEM格式證書的文件名。
CURLOPT_SSLCERTPASSWD
使用CURLOPT_SSLCERT證書需要的密碼。
CURLOPT_SSLCERTTYPE
證書的類型。支持的格式有"PEM" (默認值), "DER"和"ENG"。
在cURL 7.9.3中被加入。
CURLOPT_SSLENGINE
用來在CURLOPT_SSLKEY中指定的SSL私鑰的加密引擎變量。
CURLOPT_SSLENGINE_DEFAULT
用來做非對稱加密操作的變量。
CURLOPT_SSLKEY
包含SSL私鑰的文件名。
CURLOPT_SSLKEYPASSWD
在CURLOPT_SSLKEY中指定了的SSL私鑰的密碼。
Note:
由於這個選項包含了敏感的密碼信息，記得保證這個PHP腳本的安全。
CURLOPT_SSLKEYTYPE
CURLOPT_SSLKEY中規定的私鑰的加密類型，支持的密鑰類型為"PEM"(默認值)、"DER"和"ENG"。
CURLOPT_URL
需要獲取的URL地址，也可以在 curl_init()函數中設置。
CURLOPT_USERAGENT
在HTTP請求中包含一個"User-Agent: "頭的字符串。
CURLOPT_USERPWD
傳遞一個連接中需要的用戶名和密碼，格式為："[username]:[password]"。
第四類
對於下面的這些option的可選參數，value應該被設置一個數組：
選項
可選value值
備注
CURLOPT_HTTP200ALIASES
200響應碼數組，數組中的響應嗎被認為是正確的響應，否則被認為是錯誤的。
在cURL 7.10.3中被加入。
CURLOPT_HTTPHEADER
一個用來設置HTTP頭字段的數組。使用如下的形式的數組進行設置： array('Content-type: text/plain', 'Content-length: 100')
CURLOPT_POSTQUOTE
在FTP請求執行完成后，在服務器上執行的一組FTP命令。
CURLOPT_QUOTE
一組先於FTP請求的在服務器上執行的FTP命令。
對於下面的這些option的可選參數，value應該被設置一個流資源 （例如使用 fopen()）：
選項
可選value值
CURLOPT_FILE
設置輸出文件的位置，值是一個資源類型，默認為STDOUT (瀏覽器)。
CURLOPT_INFILE
在上傳文件的時候需要讀取的文件地址，值是一個資源類型。
CURLOPT_STDERR
設置一個錯誤輸出地址，值是一個資源類型，取代默認的STDERR。
CURLOPT_WRITEHEADER
設置header部分內容的寫入的文件地址，值是一個資源類型。
對於下面的這些option的可選參數，value應該被設置為一個回調函數名：
選項
可選value值
CURLOPT_HEADERFUNCTION
設置一個回調函數，這個函數有兩個參數，第一個是cURL的資源句柄，第二個是輸出的header數據。header數據的輸出必須依賴這個函數，返回已寫入的數據大小。
CURLOPT_PASSWDFUNCTION
設置一個回調函數，有三個參數，第一個是cURL的資源句柄，第二個是一個密碼提示符，第三個參數是密碼長度允許的最大值。返回密碼的值。
CURLOPT_PROGRESSFUNCTION
設置一個回調函數，有三個參數，第一個是cURL的資源句柄，第二個是一個文件描述符資源，第三個是長度。返回包含的數據。
CURLOPT_READFUNCTION
擁有兩個參數的回調函數，第一個是參數是會話句柄，第二是HTTP響應頭信息的字符串。使用此函數，將自行處理返回的數據。返回值為數據大小，以字節計。返回0代表EOF信號。
CURLOPT_WRITEFUNCTION
擁有兩個參數的回調函數，第一個是參數是會話句柄，第二是HTTP響應頭信息的字符串。使用此回調函數，將自行處理響應頭信息。響應頭信息是整個字符串。設置返回值為精確的已寫入字符串長度。發生錯誤時傳輸線程終止。