一、什麼是CURL?
cURL 是一個利用URL語法規定來傳輸檔案和資料的工具,支援許多協議,如HTTP、FTP、TELNET等。最爽的是,PHP也支援 cURL 函式庫。使用PHP的cURL函式庫可以簡單有效地去抓網頁。你只需要執行一個腳本,然後分析一下你所抓取的網頁,然後就可以以程式的方式得到你想要的資料了。無論是你想從一個連結上取部分數據,或是取一個XML檔案並把其導入資料庫,那怕就是簡單的獲取網頁內容,cURL 是一個功能強大的PHP庫。
二、CURL函數庫。
curl_close — 關閉一個curl會話
curl_copy_handle — 拷貝一個curl連接資源的所有內容和參數
curl_errno — 連接資源的所有內容和參數
》字串
curl_exec — 執行一個curl會話
curl_getinfo — 取得一個curl連接資源句柄的資訊
curl_init — 初始化一個curl.句柄資源
curl_multi_close — 關閉一個批次控制句柄資源
curl_multi_exec — 解析一個curl批次句柄
curl_multi_getcontent — 傳回所取得的輸出的文字流
〔〕傳輸相關的信息_multi_init — 初始化一個curl批次句柄資源
curl_multi_remove_handle — 移除curl批次句柄資源中的某一句柄資源
curl_multi_select — Get all the sockets associated with the cURL extnsion, which cannhipse associated _cURL extnsion, which cannal conjse5” — 以數組的形式為一個curl設定會話參數
curl_setopt — 為一個curl設定會話參數
curl_version — 取得curl相關的版本資訊
curl_init()函數的作用資訊
curl_init()函數的作用則是初始化函數的作用力地址。
curl_exec()函數的作用是執行一個curl會話,唯一的參數是curl_init()函數傳回的句柄。
curl_close()函數的作用是關閉一個curl會話,唯一的參數是curl_init()函數傳回的句柄。
三、PHP建立CURL請求的基本步驟
①:初始化
curl_init()
②:設定屬性
c『 。 ③:執行並取得結果 curl_exec() ④:釋放句柄 curl_close()43_close()。<?php //初始化 $curl = curl_init(); //设置抓取的url curl_setopt($curl, CURLOPT_URL, 'http://www.baidu.com'); //设置头文件的信息作为数据流输出 curl_setopt($curl, CURLOPT_HEADER, 1); //设置获取的信息以文件流的形式返回,而不是直接输出。 curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); //执行命令 $data = curl_exec($curl); //关闭URL请求 curl_close($curl); //显示获得的数据 print_r($data); ?>
<?php //初始化 $curl = curl_init(); //设置抓取的url curl_setopt($curl, CURLOPT_URL, 'http://www.baidu.com'); //设置头文件的信息作为数据流输出 curl_setopt($curl, CURLOPT_HEADER, 1); //设置获取的信息以文件流的形式返回,而不是直接输出。 curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); //设置post方式提交 curl_setopt($curl, CURLOPT_POST, 1); //设置post数据 $post_data = array( "username" => "coder", "password" => "12345" ); curl_setopt($curl, CURLOPT_POSTFIELDS, $post_data); //执行命令 $data = curl_exec($curl); //关闭URL请求 curl_close($curl); //显示获得的数据 print_r($data); ?>
//参数1:访问的URL,参数2:post数据(不填则为GET),参数3:提交的$cookies,参数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; } }
附〜的類型的值:
選項
可選value值
備註
啟用時當FTP下載時,使用EPRT (或 LPRT)指令。設定為FALSE時停用EPRT和LPRT,使用PORT指令 only.
CURLOPT_FTP_USE_EPSV
啟用時,在FTP傳輸過程中回復到PASV模式前先嘗試回覆到PASV模式。設定為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型別的值:
眀選項CURLOPT_BUFFERSIZE
每次取得的資料中讀入快取的大小,但是不保證這個值每次都會被填滿。
在cURL 7.10中被加入。
CURLOPT_CLOSEPOLICY
不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST,還存在另外三個CURLCLOSEPOLICY_,但暫時不支援。
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)或強制使用 HTTP/1.0)。
CURLOPT_HTTPAUTH
使用的HTTP驗證方法,可選的值有:CURLAUTH_BASIC、CURLAUTH_DIGEST、CURLAUTH_GSSNEGOTIATE、CURLAUTH_NTRLTH_DIGEST、CURLAUTH_GSSNEGOTIATE、CURLAUTH_NTD、RLTH_NTARLTH_GSSNEGOTIATE、CURLAUTH_NTJ、ARLTH_NTJA4ARL。
可以使用|位元域(或)操作符分隔多個值,cURL讓伺服器選擇一個支援最好的值。
CURLAUTH_ANY等價於CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM.
CURLAUTH_ANYRLTH_NTLM.
CURLAUTH_ANYATE7R4S4S4S474336_6S49RL_R4S47RL_R4S47RL_R4S49RL_R4S.S49RL_SJS.D.DRLDRL_ARETS.
CURLOPT_INFILESIZE 設定上傳檔案的大小限制,位元組(byte)為單位。 CURLOPT_LOW_SPEED_LIMIT 當傳輸速度小於CURLOPT_LOW_SPEED_LIMIT時(bytes/sec),PHP會根據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、CUPROTOTTO_FTPS、CURLPROTO_SCP、CURLPROTO_S. LE、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傳回頁面,如果沒有被修改過,並且CURNot_HEAMECOND_IFMODSINCE返回頁面,如果沒有被修改過,並且CURNot_HEA3” ,則使用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類型的值: 㟎🎀 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應該被設定一個陣列:
選項
『 0ALIASES
200回應碼數組,數組中的回應嗎被認為是正確的回應,否則被認為是錯誤的。
在cURL 7.10.3中被加入。
CURLOPT_HTTPHEADER
一個用來設定HTTP頭字段的陣列。使用如下的形式的陣列進行設定: array('Content-type: text/plain', 'Content-length: 100′)
CURLOPT_POSTQUOTE
在FTP請求執行完成後,在FTP要求執行完成後,在FTP請求執行的一組命令。
CURLOPT_QUOTE
一組先於FTP請求的在伺服器上執行的FTP指令。
對於下面的這些option的可選參數,value應該被設定一個流資源(例如使用fopen()):
選項
4URvalue值🎀 選項
CURvalue值🎀資源類型,預設為STDOUT (瀏覽器)。
CURLOPT_INFILE
在上傳檔案的時候需要讀取的檔案位址,值是一個資源型別。
CURLOPT_STDERR
設定一個錯誤輸出位址,值是一個資源類型,取代預設的STDERR。
CURLOPT_WRITEHEADER
設定header部分內容的寫入的檔案位址,值是一個資源型別。
對於下面的這些option的可選參數,value應該被設定為一個回呼函數名稱:
選項
可選value值
〜〜〜〜 CURy_LEAFoneD號,這個函數有一個回傳個是cURL的資源句柄,第二個是輸出的header資料。 header資料的輸出必須依賴這個函數,傳回已寫入的資料大小。
CURLOPT_PASSWDFUNCTION
設定一個回調函數,有三個參數,第一個是cURL的資源句柄,第二個是一個密碼提示符,第三個參數是密碼長度允許的最大值。傳回密碼的值。
CURLOPT_PROGRESSFUNCTION
設定一個回調函數,有三個參數,第一個是cURL的資源句柄,第二個是一個檔案描述子資源,第三個是長度。傳回包含的數據。
CURLOPT_READFUNCTION
擁有兩個參數的回調函數,第一個是參數是會話句柄,第二是HTTP回應頭資訊的字串。使用此函數,將自行處理傳回的資料。傳回值為資料大小,以位元組計。返回0代表EOF信號。
CURLOPT_WRITEFUNCTION
擁有兩個參數的回調函數,第一個是參數是會話句柄,第二是HTTP回應頭資訊的字串。使用此回調函數,將自行處理響應頭資訊。響應頭資訊是整個字串。設定回傳值為精確的已寫入字串長度。發生錯誤時傳輸線程終止。