一、什么是CURL?
cURL 是一個利用URL語法規(guī)定來傳輸文件和數(shù)據(jù)的工具,支持很多協(xié)議,如HTTP、FTP、TELNET等。最爽的是,PHP也支持 cURL 庫。使用PHP的cURL庫可以簡單和有效地去抓網(wǎng)頁。你只需要運行一個腳本,然后分析一下你所抓取的網(wǎng)頁,然后就可以以程序的方式得到你想要的數(shù)據(jù)了。無論是你想從從一個鏈接上取部分數(shù)據(jù),或是取一個XML文件并把其導(dǎo)入數(shù)據(jù)庫,那怕就是簡單的獲取網(wǎng)頁內(nèi)容,cURL 是一個功能強大的PHP庫。
二、CURL函數(shù)庫。
curl_close — 關(guān)閉一個curl會話
curl_copy_handle — 拷貝一個curl連接資源的所有內(nèi)容和參數(shù)
curl_errno — 返回一個包含當(dāng)前會話錯誤信息的數(shù)字編號
curl_error — 返回一個包含當(dāng)前會話錯誤信息的字符串
curl_exec — 執(zhí)行一個curl會話
curl_getinfo — 獲取一個curl連接資源句柄的信息
curl_init — 初始化一個curl會話
curl_multi_add_handle — 向curl批處理會話中添加單獨的curl句柄資源
curl_multi_close — 關(guān)閉一個批處理句柄資源
curl_multi_exec — 解析一個curl批處理句柄
curl_multi_getcontent — 返回獲取的輸出的文本流
curl_multi_info_read — 獲取當(dāng)前解析的curl的相關(guān)傳輸信息
curl_multi_init — 初始化一個curl批處理句柄資源
curl_multi_remove_handle — 移除curl批處理句柄資源中的某個句柄資源
curl_multi_select — Get all the sockets associated with the cURL extension, which can then be “selected”
curl_setopt_array — 以數(shù)組的形式為一個curl設(shè)置會話參數(shù)
curl_setopt — 為一個curl設(shè)置會話參數(shù)
curl_version — 獲取curl相關(guān)的版本信息
curl_init()函數(shù)的作用初始化一個curl會話,curl_init()函數(shù)唯一的一個參數(shù)是可選的,表示一個url地址。
curl_exec()函數(shù)的作用是執(zhí)行一個curl會話,唯一的參數(shù)是curl_init()函數(shù)返回的句柄。
curl_close()函數(shù)的作用是關(guān)閉一個curl會話,唯一的參數(shù)是curl_init()函數(shù)返回的句柄。
三、PHP建立CURL請求的基本步驟
?、伲撼跏蓟?/p>
curl_init()
?、冢涸O(shè)置屬性
curl_setopt().有一長串cURL參數(shù)可供設(shè)置,它們能指定URL請求的各個細節(jié)。
?、郏簣?zhí)行并獲取結(jié)果
curl_exec()
④:釋放句柄
curl_close()
四、CURL實現(xiàn)GET和POST
①:GET方式實現(xiàn)
<?php
//初始化
$curl = curl_init();
//設(shè)置抓取的url
curl_setopt($curl, CURLOPT_URL, 'http://m.lncdfzh.com.cn');
//設(shè)置頭文件的信息作為數(shù)據(jù)流輸出
curl_setopt($curl, CURLOPT_HEADER, 1);
//設(shè)置獲取的信息以文件流的形式返回,而不是直接輸出。
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
//執(zhí)行命令
$data = curl_exec($curl);
//關(guān)閉URL請求
curl_close($curl);
//顯示獲得的數(shù)據(jù)
print_r($data);
?>
②:POST方式實現(xiàn)
<?php
//初始化
$curl = curl_init();
//設(shè)置抓取的url
curl_setopt($curl, CURLOPT_URL, 'http://m.lncdfzh.com.cn');
//設(shè)置頭文件的信息作為數(shù)據(jù)流輸出
curl_setopt($curl, CURLOPT_HEADER, 1);
//設(shè)置獲取的信息以文件流的形式返回,而不是直接輸出。
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
//設(shè)置post方式提交
curl_setopt($curl, CURLOPT_POST, 1);
//設(shè)置post數(shù)據(jù)
$post_data = array(
"username" => "coder",
"password" => "12345"
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $post_data);
//執(zhí)行命令
$data = curl_exec($curl);
//關(guān)閉URL請求
curl_close($curl);
//顯示獲得的數(shù)據(jù)
print_r($data);
?>
③:如果獲得的數(shù)據(jù)時json格式的,使用json_decode函數(shù)解釋成數(shù)組。
$output_array = json_decode($output,true);
如果使用json_decode($output)解析的話,將會得到object類型的數(shù)據(jù)。
五、我自己封裝的一個函數(shù)
//參數(shù)1:訪問的URL,參數(shù)2:post數(shù)據(jù)(不填則為GET),參數(shù)3:提交的$cookies,參數(shù)4:是否返回$cookies
function curl_request($url,$post='',$cookie='', $returnCookie=0){
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_USERAGENT, 'Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/6.0)');
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($curl, CURLOPT_AUTOREFERER, 1);
curl_setopt($curl, CURLOPT_REFERER, "http://XXX");
if($post) {
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($post));
}
if($cookie) {
curl_setopt($curl, CURLOPT_COOKIE, $cookie);
}
curl_setopt($curl, CURLOPT_HEADER, $returnCookie);
curl_setopt($curl, CURLOPT_TIMEOUT, 10);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$data = curl_exec($curl);
if (curl_errno($curl)) {
return curl_error($curl);
}
curl_close($curl);
if($returnCookie){
list($header, $body) = explode("\r\n\r\n", $data, 2);
preg_match_all("/Set\-Cookie:([^;]*);/", $header, $matches);
$info['cookie'] = substr($matches[1][0], 1);
$info['content'] = $body;
return $info;
}else{
return $data;
}
}
附可選參數(shù)說明:
第一類:
對于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個bool類型的值:
選項
可選value值
備注
CURLOPT_AUTOREFERER
當(dāng)根據(jù)Location:重定向時,自動設(shè)置header中的Referer:信息。
CURLOPT_BINARYTRANSFER
在啟用CURLOPT_RETURNTRANSFER的時候,返回原生的(Raw)輸出。
CURLOPT_COOKIESESSION
啟用時curl會僅僅傳遞一個session cookie,忽略其他的cookie,默認狀況下cURL會將所有的cookie返回給服務(wù)端。session cookie是指那些用來判斷服務(wù)器端的session是否有效而存在的cookie。
CURLOPT_CRLF
啟用時將Unix的換行符轉(zhuǎn)換成回車換行符。
CURLOPT_DNS_USE_GLOBAL_CACHE
啟用時會啟用一個全局的DNS緩存,此項為線程安全的,并且默認啟用。
CURLOPT_FAILONERROR
顯示HTTP狀態(tài)碼,默認行為是忽略編號小于等于400的HTTP信息。
CURLOPT_FILETIME
啟用時會嘗試修改遠程文檔中的信息。結(jié)果信息會通過 curl_getinfo()函數(shù)的CURLINFO_FILETIME選項返回。curl_getinfo().
CURLOPT_FOLLOWLOCATION
啟用時會將服務(wù)器服務(wù)器返回的”Location: “放在header中遞歸的返回給服務(wù)器,使用CURLOPT_MAXREDIRS可以限定遞歸返回的數(shù)量。
CURLOPT_FORBID_REUSE
在完成交互以后強迫斷開連接,不能重用。
CURLOPT_FRESH_CONNECT
強制獲取一個新的連接,替代緩存中的連接。
CURLOPT_FTP_USE_EPRT
啟用時當(dāng)FTP下載時,使用EPRT (或 LPRT)命令。設(shè)置為FALSE時禁用EPRT和LPRT,使用PORT命令 only.
CURLOPT_FTP_USE_EPSV
啟用時,在FTP傳輸過程中回復(fù)到PASV模式前首先嘗試EPSV命令。設(shè)置為FALSE時禁用EPSV命令。
CURLOPT_FTPAPPEND
啟用時追加寫入文件而不是覆蓋它。
CURLOPT_FTPASCII
CURLOPT_TRANSFERTEXT的別名。
CURLOPT_FTPLISTONLY
啟用時只列出FTP目錄的名字。
CURLOPT_HEADER
啟用時會將頭文件的信息作為數(shù)據(jù)流輸出。
CURLINFO_HEADER_OUT
啟用時追蹤句柄的請求字符串。
從 PHP 5.1.3 開始可用。CURLINFO_前綴是故意的(intentional)。
CURLOPT_HTTPGET
啟用時會設(shè)置HTTP的method為GET,因為GET是默認是,所以只在被修改的情況下使用。
CURLOPT_HTTPPROXYTUNNEL
啟用時會通過HTTP代理來傳輸。
CURLOPT_MUTE
啟用時將cURL函數(shù)中所有修改過的參數(shù)恢復(fù)默認值。
CURLOPT_NETRC
在連接建立以后,訪問~/.netrc文件獲取用戶名和密碼信息連接遠程站點。
CURLOPT_NOBODY
啟用時將不對HTML中的BODY部分進行輸出。
CURLOPT_NOPROGRESS
啟用時關(guān)閉curl傳輸?shù)倪M度條,此項的默認設(shè)置為啟用。
Note:
PHP自動地設(shè)置這個選項為TRUE,這個選項僅僅應(yīng)當(dāng)在以調(diào)試為目的時被改變。
CURLOPT_NOSIGNAL
啟用時忽略所有的curl傳遞給php進行的信號。在SAPI多線程傳輸時此項被默認啟用。
cURL 7.10時被加入。
CURLOPT_POST
啟用時會發(fā)送一個常規(guī)的POST請求,類型為:application/x-www-form-urlencoded,就像表單提交的一樣。
CURLOPT_PUT
啟用時允許HTTP發(fā)送文件,必須同時設(shè)置CURLOPT_INFILE和CURLOPT_INFILESIZE。
CURLOPT_RETURNTRANSFER
將 curl_exec()獲取的信息以文件流的形式返回,而不是直接輸出。
CURLOPT_SSL_VERIFYPEER
禁用后cURL將終止從服務(wù)端進行驗證。使用CURLOPT_CAINFO選項設(shè)置證書使用CURLOPT_CAPATH選項設(shè)置證書目錄 如果CURLOPT_SSL_VERIFYPEER(默認值為2)被啟用,CURLOPT_SSL_VERIFYHOST需要被設(shè)置成TRUE否則設(shè)置為FALSE。
自cURL 7.10開始默認為TRUE。從cURL 7.10開始默認綁定安裝。
CURLOPT_TRANSFERTEXT
啟用后對FTP傳輸使用ASCII模式。對于LDAP,它檢索純文本信息而非HTML。在Windows系統(tǒng)上,系統(tǒng)不會把STDOUT設(shè)置成binary模式。
CURLOPT_UNRESTRICTED_AUTH
在使用CURLOPT_FOLLOWLOCATION產(chǎn)生的header中的多個locations中持續(xù)追加用戶名和密碼信息,即使域名已發(fā)生改變。
CURLOPT_UPLOAD
啟用后允許文件上傳。
CURLOPT_VERBOSE
啟用時會匯報所有的信息,存放在STDERR或指定的CURLOPT_STDERR中。
第二類:
對于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個integer類型的值:
選項
可選value值
備注
CURLOPT_BUFFERSIZE
每次獲取的數(shù)據(jù)中讀入緩存的大小,但是不保證這個值每次都會被填滿。
在cURL 7.10中被加入。
CURLOPT_CLOSEPOLICY
不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST,還存在另外三個CURLCLOSEPOLICY_,但是cURL暫時還不支持。
CURLOPT_CONNECTTIMEOUT
在發(fā)起連接前等待的時間,如果設(shè)置為0,則無限等待。
CURLOPT_CONNECTTIMEOUT_MS
嘗試連接等待的時間,以毫秒為單位。如果設(shè)置為0,則無限等待。
在cURL 7.16.2中被加入。從PHP 5.2.3開始可用。
CURLOPT_DNS_CACHE_TIMEOUT
設(shè)置在內(nèi)存中保存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讓服務(wù)器選擇一個支持最好的值。
CURLAUTH_ANY等價于CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM.
CURLAUTH_ANYSAFE等價于CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM.
CURLOPT_INFILESIZE
設(shè)定上傳文件的大小限制,字節(jié)(byte)為單位。
CURLOPT_LOW_SPEED_LIMIT
當(dāng)傳輸速度小于CURLOPT_LOW_SPEED_LIMIT時(bytes/sec),PHP會根據(jù)CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。
CURLOPT_LOW_SPEED_TIME
當(dāng)傳輸速度小于CURLOPT_LOW_SPEED_LIMIT時(bytes/sec),PHP會根據(jù)CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。
CURLOPT_MAXCONNECTS
允許的最大連接數(shù)量,超過是會通過CURLOPT_CLOSEPOLICY決定應(yīng)該停止哪些連接。
CURLOPT_MAXREDIRS
指定最多的HTTP重定向的數(shù)量,這個選項是和CURLOPT_FOLLOWLOCATION一起使用的。
CURLOPT_PORT
用來指定連接端口。(可選項)
CURLOPT_PROTOCOLS
CURLPROTO_*的位域指。如果被啟用,位域值會限定libcurl在傳輸過程中有哪些可使用的協(xié)議。這將允許你在編譯libcurl時支持眾多協(xié)議,但是限制只是用它們中被允許使用的一個子集。默認libcurl將會使用全部它支持的協(xié)議。參見CURLOPT_REDIR_PROTOCOLS.
可用的協(xié)議選項為: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中的位域標(biāo)志來設(shè)置相應(yīng)選項。對于代理驗證只有CURLAUTH_BASIC和CURLAUTH_NTLM當(dāng)前被支持。
在cURL 7.10.7中被加入。
CURLOPT_PROXYPORT
代理服務(wù)器的端口。端口也可以在CURLOPT_PROXY中進行設(shè)置。
CURLOPT_PROXYTYPE
不是CURLPROXY_HTTP (默認值) 就是CURLPROXY_SOCKS5。
在cURL 7.10中被加入。
CURLOPT_REDIR_PROTOCOLS
CURLPROTO_*中的位域值。如果被啟用,位域值將會限制傳輸線程在CURLOPT_FOLLOWLOCATION開啟時跟隨某個重定向時可使用的協(xié)議。這將使你對重定向時限制傳輸線程使用被允許的協(xié)議子集默認libcurl將會允許除FILE和SCP之外的全部協(xié)議。這個和7.19.4預(yù)發(fā)布版本種無條件地跟隨所有支持的協(xié)議有一些不同。關(guān)于協(xié)議常量,請參照CURLOPT_PROTOCOLS。
在cURL 7.19.4中被加入。
CURLOPT_RESUME_FROM
在恢復(fù)傳輸時傳遞一個字節(jié)偏移量(用來斷點續(xù)傳)。
CURLOPT_SSL_VERIFYHOST
1 檢查服務(wù)器SSL證書中是否存在一個公用名(common name)。譯者注:公用名(Common Name)一般來講就是填寫你將要申請SSL證書的域名 (domain)或子域名(sub domain)。2 檢查公用名是否存在,并且是否與提供的主機名匹配。
CURLOPT_SSLVERSION
使用的SSL版本(2 或 3)。默認情況下PHP會自己檢測這個值,盡管有些情況下需要手動地進行設(shè)置。
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
設(shè)置cURL允許執(zhí)行的最長秒數(shù)。
CURLOPT_TIMEOUT_MS
設(shè)置cURL允許執(zhí)行的最長毫秒數(shù)。
在cURL 7.16.2中被加入。從PHP 5.2.3起可使用。
CURLOPT_TIMEVALUE
設(shè)置一個CURLOPT_TIMECONDITION使用的時間戳,在默認狀態(tài)下使用的是CURL_TIMECOND_IFMODSINCE。
第三類:
對于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個string類型的值:
選項
可選value值
備注
CURLOPT_CAINFO
一個保存著1個或多個用來讓服務(wù)端驗證的證書的文件名。這個參數(shù)僅僅在和CURLOPT_SSL_VERIFYPEER一起使用時才有意義。 .
CURLOPT_CAPATH
一個保存著多個CA證書的目錄。這個選項是和CURLOPT_SSL_VERIFYPEER一起使用的。
CURLOPT_COOKIE
設(shè)定HTTP請求中”Cookie: “部分的內(nèi)容。多個cookie用分號分隔,分號后帶一個空格(例如, “fruit=apple; colour=red”)。
CURLOPT_COOKIEFILE
包含cookie數(shù)據(jù)的文件名,cookie文件的格式可以是Netscape格式,或者只是純HTTP頭部信息存入文件。
CURLOPT_COOKIEJAR
連接結(jié)束后保存cookie信息的文件。
CURLOPT_CUSTOMREQUEST
使用一個自定義的請求信息來代替”GET”或”HEAD”作為HTTP請求。這對于執(zhí)行”DELETE” 或者其他更隱蔽的HTTP請求。有效值如”GET”,”POST”,”CONNECT”等等。也就是說,不要在這里輸入整個HTTP請求。例如輸入”GET /index.html HTTP/1.0\r\n\r\n”是不正確的。
Note:
在確定服務(wù)器支持這個自定義請求的方法前不要使用。
CURLOPT_EGDSOCKET
類似CURLOPT_RANDOM_FILE,除了一個Entropy Gathering Daemon套接字。
CURLOPT_ENCODING
HTTP請求頭中”Accept-Encoding: “的值。支持的編碼有”identity”,”deflate”和”gzip”。如果為空字符串””,請求頭會發(fā)送所有支持的編碼類型。
在cURL 7.10中被加入。
CURLOPT_FTPPORT
這個值將被用來獲取供FTP”POST”指令所需要的IP地址?!盤OST”指令告訴遠程服務(wù)器連接到我們指定的IP地址。這個字符串可以是純文本的IP地址、主機名、一個網(wǎng)絡(luò)接口名(UNIX下)或者只是一個’-’來使用默認的IP地址。
CURLOPT_INTERFACE
網(wǎng)絡(luò)發(fā)送接口名,可以是一個接口名、IP地址或者是一個主機名。
CURLOPT_KRB4LEVEL
KRB4 (Kerberos 4) 安全級別。下面的任何值都是有效的(從低到高的順序):”clear”、”safe”、”confidential”、”private”.。如果字符串和這些都不匹配,將使用”private”。這個選項設(shè)置為NULL時將禁用KRB4 安全認證。目前KRB4 安全認證只能用于FTP傳輸。
CURLOPT_POSTFIELDS
全部數(shù)據(jù)使用HTTP協(xié)議中的”POST”操作來發(fā)送。要發(fā)送文件,在文件名前面加上@前綴并使用完整路徑。這個參數(shù)可以通過urlencoded后的字符串類似’para1=val1?2=val2&…’或使用一個以字段名為鍵值,字段數(shù)據(jù)為值的數(shù)組。如果value是一個數(shù)組,Content-Type頭將會被設(shè)置成multipart/form-data。
CURLOPT_PROXY
HTTP代理通道。
CURLOPT_PROXYUSERPWD
一個用來連接到代理的”[username]:[password]“格式的字符串。
CURLOPT_RANDOM_FILE
一個被用來生成SSL隨機數(shù)種子的文件名。
CURLOPT_RANGE
以”X-Y”的形式,其中X和Y都是可選項獲取數(shù)據(jù)的范圍,以字節(jié)計。HTTP傳輸線程也支持幾個這樣的重復(fù)項中間用逗號分隔如”X-Y,N-M”。
CURLOPT_REFERER
在HTTP請求頭中”Referer: “的內(nèi)容。
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中規(guī)定的私鑰的加密類型,支持的密鑰類型為”PEM”(默認值)、”DER”和”ENG”。
CURLOPT_URL
需要獲取的URL地址,也可以在 curl_init()函數(shù)中設(shè)置。
CURLOPT_USERAGENT
在HTTP請求中包含一個”User-Agent: “頭的字符串。
CURLOPT_USERPWD
傳遞一個連接中需要的用戶名和密碼,格式為:”[username]:[password]“。
第四類
對于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個數(shù)組:
選項
可選value值
備注
CURLOPT_HTTP200ALIASES
200響應(yīng)碼數(shù)組,數(shù)組中的響應(yīng)嗎被認為是正確的響應(yīng),否則被認為是錯誤的。
在cURL 7.10.3中被加入。
CURLOPT_HTTPHEADER
一個用來設(shè)置HTTP頭字段的數(shù)組。使用如下的形式的數(shù)組進行設(shè)置: array(‘Content-type: text/plain’, ‘Content-length: 100′)
CURLOPT_POSTQUOTE
在FTP請求執(zhí)行完成后,在服務(wù)器上執(zhí)行的一組FTP命令。
CURLOPT_QUOTE
一組先于FTP請求的在服務(wù)器上執(zhí)行的FTP命令。
對于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個流資源 (例如使用 fopen()):
選項
可選value值
CURLOPT_FILE
設(shè)置輸出文件的位置,值是一個資源類型,默認為STDOUT (瀏覽器)。
CURLOPT_INFILE
在上傳文件的時候需要讀取的文件地址,值是一個資源類型。
CURLOPT_STDERR
設(shè)置一個錯誤輸出地址,值是一個資源類型,取代默認的STDERR。
CURLOPT_WRITEHEADER
設(shè)置header部分內(nèi)容的寫入的文件地址,值是一個資源類型。
對于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置為一個回調(diào)函數(shù)名:
選項
可選value值
CURLOPT_HEADERFUNCTION
設(shè)置一個回調(diào)函數(shù),這個函數(shù)有兩個參數(shù),第一個是cURL的資源句柄,第二個是輸出的header數(shù)據(jù)。header數(shù)據(jù)的輸出必須依賴這個函數(shù),返回已寫入的數(shù)據(jù)大小。
CURLOPT_PASSWDFUNCTION
設(shè)置一個回調(diào)函數(shù),有三個參數(shù),第一個是cURL的資源句柄,第二個是一個密碼提示符,第三個參數(shù)是密碼長度允許的最大值。返回密碼的值。
CURLOPT_PROGRESSFUNCTION
設(shè)置一個回調(diào)函數(shù),有三個參數(shù),第一個是cURL的資源句柄,第二個是一個文件描述符資源,第三個是長度。返回包含的數(shù)據(jù)。
CURLOPT_READFUNCTION
擁有兩個參數(shù)的回調(diào)函數(shù),第一個是參數(shù)是會話句柄,第二是HTTP響應(yīng)頭信息的字符串。使用此函數(shù),將自行處理返回的數(shù)據(jù)。返回值為數(shù)據(jù)大小,以字節(jié)計。返回0代表EOF信號。
CURLOPT_WRITEFUNCTION
擁有兩個參數(shù)的回調(diào)函數(shù),第一個是參數(shù)是會話句柄,第二是HTTP響應(yīng)頭信息的字符串。使用此回調(diào)函數(shù),將自行處理響應(yīng)頭信息。響應(yīng)頭信息是整個字符串。設(shè)置返回值為精確的已寫入字符串長度。發(fā)生錯誤時傳輸線程終止。