轉發的 php curl 使用

<?php
  3 /**
  4 * CURL HTTP請求工具,
  5 * 作者:袁維
  6 * 參考:鄭GG的BLOG
  7 * 支持以下功能:
  8 * 1:支持ssl連接和proxy代理連接
  9 * 2: 對cookie的自動支持
10 * 3: 簡單的GET/POST常規操作
11 * 4: 支持單個文件上傳或同字段的多文件上傳,支持相對路徑或絕對路徑.
12 * 5: 支持返回發送請求前和請求後所有的服務器信息和服務器Header信息
13 * 6: 自動支持lighttpd服務器
14 * 7: 支持自動設置 REFERER 引用頁
15 * 8: 自動支持服務器301跳轉或重寫問題(謝謝鄭GG)
16 * 9: 其它可選項,如自定義端口,超時時間,USERAGENT,Gzip壓縮等.
17 */
18 class Curl{
19
20 //CURL句柄
21 private $ch = null;
22 //CURL執行前後所設置或服務器端返回的信息
23 private $info = array();
24 //CURL SETOPT 信息
25 private $setopt = array(
26 //訪問的端口,http默認是 80
27 'port'=>80,
28 //客戶端 USERAGENT,如:"Mozilla/4.0",爲空則使用用戶的瀏覽器
29 'userAgent'=>'',
30 //連接超時時間
31 'timeOut'=>30,
32 //是否使用 COOKIE 建議打開,因爲一般網站都會用到
33 'useCookie'=>true,
34 //是否支持SSL
35 'ssl'=>false,
36 //客戶端是否支持 gzip壓縮
37 'gzip'=>true,
38
39 //是否使用代理
40 'proxy'=>false,
41 //代理類型,可選擇 HTTP 或 SOCKS5
42 'proxyType'=>'HTTP',
43 //代理的主機地址,如果是 HTTP 方式則要寫成URL形式如:"http://www.proxy.com"
44 //SOCKS5 方式則直接寫主機域名爲IP的形式,如:"192.168.1.1"
45 'proxyHost'=>'http://www.proxy.com',
46 //代理主機的端口
47 'proxyPort'=>1234,
48 //代理是否要身份認證(HTTP方式時)
49 'proxyAuth'=>false,
50 //認證的方式.可選擇 BASIC 或 NTLM 方式
51 'proxyAuthType'=>'BASIC',
52 //認證的用戶名和密碼
53 'proxyAuthUser'=>'user',
54 'proxyAuthPwd'=>'password',
55 );
56
57 /**
58 * 構造函數
59 *
60 * @param array $setopt :請參考 private $setopt 來設置
61 */
62 public function __construct($setopt=array())
63 {
64 //合併用戶的設置和系統的默認設置
65 $this->setopt = array_merge($this->setopt,$setopt);
66 //如果沒有安裝CURL則終止程序
67 function_exists('curl_init') || die('CURL Library Not Loaded');
68 //初始化
69 $this->ch = curl_init();
70 //設置CURL連接的端口
71 curl_setopt($this->ch, CURLOPT_PORT, $this->setopt['port']);
72 //使用代理
73 if($this->setopt['proxy']){
74 $proxyType = $this->setopt['proxyType']=='HTTP' ? CURLPROXY_HTTP : CURLPROXY_SOCKS5;
75 curl_setopt($this->ch, CURLOPT_PROXYTYPE, $proxyType);
76 curl_setopt($this->ch, CURLOPT_PROXY, $this->setopt['proxyHost']);
77 curl_setopt($this->ch, CURLOPT_PROXYPORT, $this->setopt['proxyPort']);
78 //代理要認證
79 if($this->setopt['proxyAuth']){
80 $proxyAuthType = $this->setopt['proxyAuthType']=='BASIC' ? CURLAUTH_BASIC : CURLAUTH_NTLM;
81 curl_setopt($this->ch, CURLOPT_PROXYAUTH, $proxyAuthType);
82 $user = "[{$this->setopt['proxyAuthUser']}]:[{$this->setopt['proxyAuthPwd']}]";
83 curl_setopt($this->ch, CURLOPT_PROXYUSERPWD, $user);
84 }
85 }
86 //啓用時會將服務器服務器返回的“Location:”放在header中遞歸的返回給服務器
87 curl_setopt($this->ch, CURLOPT_FOLLOWLOCATION, true);
88 //打開的支持SSL
89 if($this->setopt['ssl']){
90 //不對認證證書來源的檢查
91 curl_setopt($this->ch, CURLOPT_SSL_VERIFYPEER, false);
92 //從證書中檢查SSL加密算法是否存在
93 curl_setopt($this->ch, CURLOPT_SSL_VERIFYHOST, true);
94 }
95 //設置http頭,支持lighttpd服務器的訪問
96 $header[]= 'Expect:';
97 curl_setopt($this->ch, CURLOPT_HTTPHEADER, $header);
98 //設置 HTTP USERAGENT
99 $userAgent = $this->setopt['userAgent'] ? $this->setopt['userAgent'] : $_SERVER['HTTP_USER_AGENT'];
100 curl_setopt($this->ch, CURLOPT_USERAGENT, $userAgent);
101 //設置連接等待時間,0不等待
102 curl_setopt($this->ch, CURLOPT_CONNECTTIMEOUT, $this->setopt['timeOut']);
103 //設置curl允許執行的最長秒數
104 curl_setopt($this->ch, CURLOPT_TIMEOUT, $this->setopt['timeOut']);
105 //設置客戶端是否支持 gzip壓縮
106 if($this->setopt['gzip']){
107 curl_setopt($this->ch, CURLOPT_ENCODING, 'gzip');
108 }
109 //是否使用到COOKIE
110 if($this->setopt['useCookie']){
111 //生成存放臨時COOKIE的文件(要絕對路徑)
112 $cookfile = tempnam(sys_get_temp_dir(),'cuk');
113 //連接關閉以後,存放cookie信息
114 curl_setopt($this->ch, CURLOPT_COOKIEJAR, $cookfile);
115 curl_setopt($this->ch, CURLOPT_COOKIEFILE, $cookfile);
116 }
117 //是否將頭文件的信息作爲數據流輸出(HEADER信息),這裏保留報文
118 curl_setopt($this->ch, CURLOPT_HEADER, true);
119 //獲取的信息以文件流的形式返回,而不是直接輸出。
120 curl_setopt($this->ch, CURLOPT_RETURNTRANSFER, true) ;
121 curl_setopt($this->ch, CURLOPT_BINARYTRANSFER, true) ;
122 }
123
124 /**
125 * 以 GET 方式執行請求
126 *
127 * @param string $url :請求的URL
128 * @param array $params :請求的參數,格式如: array('id'=>10,'name'=>'yuanwei')
129 * @param array $referer :引用頁面,爲空時自動設置,如果服務器有對這個控制的話則一定要設置的.
130 * @return 錯誤返回:false 正確返回:結果內容
131 */
132 public function get($url,$params=array(), $referer='')
133 {
134 return $this->_request('GET', $url, $params, array(), $referer);
135 }
136
137 /**
138 * 以 POST 方式執行請求
139 *
140 * @param string $url :請求的URL
141 * @param array $params :請求的參數,格式如: array('id'=>10,'name'=>'yuanwei')
142 * @param array $uploadFile :上傳的文件,支持相對路徑,格式如下
143 * 單個文件上傳:array('img1'=>'./file/a.jpg')
144 * 同字段多個文件上傳:array('img'=>array('./file/a.jpg','./file/b.jpg'))
145 * @param array $referer :引用頁面,引用頁面,爲空時自動設置,如果服務器有對這個控制的話則一定要設置的.
146 * @return 錯誤返回:false 正確返回:結果內容
147 */
148 public function post($url,$params=array(),$uploadFile=array(), $referer='')
149 {
150 return $this->_request('POST', $url, $params, $uploadFile, $referer);
151 }
152
153 /**
154 * 得到錯誤信息
155 *
156 * @return string
157 */
158 public function error()
159 {
160 return curl_error($this->ch);
161 }
162
163 /**
164 * 得到錯誤代碼
165 *
166 * @return int
167 */
168 public function errno()
169 {
170 return curl_errno($this->ch);
171 }
172
173 /**
174 * 得到發送請求前和請求後所有的服務器信息和服務器Header信息,其中
175 * [before] :請求前所設置的信息
176 * [after] :請求後所有的服務器信息
177 * [header] :服務器Header報文信息
178 *
179 * @return array
180 */
181 public function getInfo()
182 {
183 return $this->info;
184 }
185
186 /**
187 * 析構函數
188 *
189 */
190 public function __destruct()
191 {
192 //關閉CURL
193 curl_close($this->ch);
194 }
195
196 /**
197 * 私有方法:執行最終請求
198 *
199 * @param string $method :HTTP請求方式
200 * @param string $url :請求的URL
201 * @param array $params :請求的參數
202 * @param array $uploadFile :上傳的文件(只有POST時才生效)
203 * @param array $referer :引用頁面
204 * @return 錯誤返回:false 正確返回:結果內容
205 */
206 private function _request($method, $url, $params=array(), $uploadFile=array(), $referer='')
207 {
208 //如果是以GET方式請求則要連接到URL後面
209 if($method == 'GET'){
210 $url = $this->_parseUrl($url,$params);
211 }
212 //設置請求的URL
213 curl_setopt($this->ch, CURLOPT_URL, $url);
214 //如果是POST
215 if($method == 'POST'){
216 //發送一個常規的POST請求,類型爲:application/x-www-form-urlencoded
217 curl_setopt($this->ch, CURLOPT_POST, true) ;
218 //設置POST字段值
219 $postData = $this->_parsmEncode($params,false);
220 //如果有上傳文件
221 if($uploadFile){
222 foreach($uploadFile as $key=>$file){
223 if(is_array($file)){
224 $n = 0;
225 foreach($file as $f){
226 //文件必需是絕對路徑
227 $postData[$key.'['.$n++.']'] = '@'.realpath($f);
228 }
229 }else{
230 $postData[$key] = '@'.realpath($file);
231 }
232 }
233 }
234 //pr($postData); die;
235 curl_setopt($this->ch, CURLOPT_POSTFIELDS, $postData);
236 }
237 //設置了引用頁,否則自動設置
238 if($referer){
239 curl_setopt($this->ch, CURLOPT_REFERER, $referer);
240 }else{
241 curl_setopt($this->ch, CURLOPT_AUTOREFERER, true);
242 }
243 //得到所有設置的信息
244 $this->info['before'] = curl_getinfo($this->ch);
245 //開始執行請求
246 $result = curl_exec($this->ch);
247 //得到報文頭
248 $headerSize = curl_getinfo($this->ch, CURLINFO_HEADER_SIZE);
249 $this->info['header'] = substr($result, 0, $headerSize);
250 //去掉報文頭
251 $result = substr($result, $headerSize);
252 //得到所有包括服務器返回的信息
253 $this->info['after'] = curl_getinfo($this->ch);
254 //如果請求成功
255 if($this->errno() == 0){ //&& $this->info['after']['http_code'] == 200
256 return $result;
257 }else{
258 return false;
259 }
260
261 }
262
263 /**
264 * 返回解析後的URL,GET方式時會用到
265 *
266 * @param string $url :URL
267 * @param array $params :加在URL後的參數
268 * @return string
269 */
270 private function _parseUrl($url,$params)
271 {
272 $fieldStr = $this->_parsmEncode($params);
273 if($fieldStr){
274 $url .= strstr($url,'?')===false ? '?' : '&';
275 $url .= $fieldStr;
276 }
277 return $url;
278 }
279
280 /**
281 * 對參數進行ENCODE編碼
282 *
283 * @param array $params :參數
284 * @param bool $isRetStr : true:以字符串返回 false:以數組返回
285 * @return string || array
286 */
287 private function _parsmEncode($params,$isRetStr=true)
288 {
289 $fieldStr = '';
290 $spr = '';
291 $result = array();
292 foreach($params as $key=>$value){
293 $value = urlencode($value);
294 $fieldStr .= $spr.$key .'='. $value;
295 $spr = '&';
296 $result[$key] = $value;
297 }
298 return $isRetStr ? $fieldStr : $result;
299 }
300 }

 

 

類在線下載(download)

調用方式:

include(‘class.curl.php’);
$cu = new Curl();

//得到 baidu 的首頁內容
echo $cu->get(‘http://www.baidu.com’);

//登錄到QuickPHP實例中並且得到所有用戶信息
$cu->post(‘http://www.myquickphp.com/code/qpdemo/?c=main&a=login’,array(‘uname’=>’admin’,'upass’=>’admin’));
echo $cu->get(‘http://www.myquickphp.com/code/qpdemo’);

//向 http://a.com/a.php 上傳內容和文件, a.php 的測試代碼可以如下:
//<?php print_r($_POST);print_r($_FILES); />
echo $cu->post(‘http://a.com/a.php’,array(‘id’=>1,’name’=>’yuanwei’),
array(‘img’=>’file/a.jpg’,'files’=>array(‘file/1.zip’,'file/2.zip’)));

//得到所有調試信息
echo ‘<br/>’,'ERRNO=’,$cu->errno();
echo ‘<br/>’,'ERROR=’,$cu->error();
echo ‘<pre>’.print_r($cu->getinfo(),true).’</pre>’;

以下爲更多 CURL 的參數,來自網絡收集:

PHP中的CURL函數庫(Client URL Library Function)

curl_close — 關閉一個curl會話
curl_copy_handle — 拷貝一個curl連接資源的所有內容和參數
curl_errno — 返回一個包含當前會話錯誤信息的數字編號
curl_error — 返回一個包含當前會話錯誤信息的字符串
curl_exec — 執行一個curl會話
curl_getinfo — 獲取一個curl連接資源句柄的信息
curl_init — 初始化一個curl會話
curl_multi_add_handle — 向curl批處理會話中添加單獨的curl句柄資源
curl_multi_close — 關閉一個批處理句柄資源
curl_multi_exec — 解析一個curl批處理句柄
curl_multi_getcontent — 返回獲取的輸出的文本流
curl_multi_info_read — 獲取當前解析的curl的相關傳輸信息
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 — 以數組的形式爲一個curl設置會話參數
curl_setopt — 爲一個curl設置會話參數
curl_version — 獲取curl相關的版本信息

curl_init()函數的作用初始化一個curl會話,curl_init()函數唯一的一個參數是可選的,表示一個url地址。
curl_exec()函數的作用是執行一個curl會話,唯一的參數是curl_init()函數返回的句柄。
curl_close()函數的作用是關閉一個curl會話,唯一的參數是curl_init()函數返回的句柄。

可選的常量包括:

CURLINFO_EFFECTIVE_URL
最後一個有效的url地址

CURLINFO_HTTP_CODE
最後一個收到的HTTP代碼

CURLINFO_FILETIME
遠程獲取文檔的時間,如果無法獲取,則返回值爲“-1”

CURLINFO_TOTAL_TIME
最後一次傳輸所消耗的時間

CURLINFO_NAMELOOKUP_TIME
名稱解析所消耗的時間

CURLINFO_CONNECT_TIME
建立連接所消耗的時間

CURLINFO_PRETRANSFER_TIME
從建立連接到準備傳輸所使用的時間

CURLINFO_STARTTRANSFER_TIME
從建立連接到傳輸開始所使用的時間

CURLINFO_REDIRECT_TIME
在事務傳輸開始前重定向所使用的時間

CURLINFO_SIZE_UPLOAD
上傳數據量的總值

CURLINFO_SIZE_DOWNLOAD
下載數據量的總值

CURLINFO_SPEED_DOWNLOAD
平均下載速度

CURLINFO_SPEED_UPLOAD
平均上傳速度

CURLINFO_HEADER_SIZE
header部分的大小

CURLINFO_HEADER_OUT
發送請求的字符串

CURLINFO_REQUEST_SIZE
在HTTP請求中有問題的請求的大小

CURLINFO_SSL_VERIFYRESULT
Result of SSL certification verification requested by setting CURLOPT_SSL_VERIFYPEER

CURLINFO_CONTENT_LENGTH_DOWNLOAD
從Content-Length: field中讀取的下載內容長度

CURLINFO_CONTENT_LENGTH_UPLOAD
上傳內容大小的說明

CURLINFO_CONTENT_TYPE
下載內容的“Content-type”值,NULL表示服務器沒有發送有效的“Content-Type: header”

curl_setopt()函數的作用是爲一個curl設置會話參數。curl_setopt_array()函數的作用是以數組的形式爲一個curl設置會話參數。

可設置的參數有:

CURLOPT_AUTOREFERER
自動設置header中的referer信息

CURLOPT_BINARYTRANSFER
在啓用CURLOPT_RETURNTRANSFER時候將獲取數據返回

CURLOPT_COOKIESESSION
啓用時curl會僅僅傳遞一個session cookie,忽略其他的cookie,默認狀況下curl會將所有的cookie返回給服務端。session cookie是指那些用來判斷服務器端的session是否有效而存在的cookie。

CURLOPT_CRLF
啓用時將Unix的換行符轉換成回車換行符。

CURLOPT_DNS_USE_GLOBAL_CACHE
啓用時會啓用一個全局的DNS緩存,此項爲線程安全的,並且默認爲true。

CURLOPT_FAILONERROR
顯示HTTP狀態碼,默認行爲是忽略編號小於等於400的HTTP信息

CURLOPT_FILETIME
啓用時會嘗試修改遠程文檔中的信息。結果信息會通過curl_getinfo()函數的CURLINFO_FILETIME選項返回。

CURLOPT_FOLLOWLOCATION
啓用時會將服務器服務器返回的“Location:”放在header中遞歸的返回給服務器,使用CURLOPT_MAXREDIRS可以限定遞歸返回的數量。

CURLOPT_FORBID_REUSE
在完成交互以後強迫斷開連接,不能重用。

CURLOPT_FRESH_CONNECT
強制獲取一個新的連接,替代緩存中的連接。

CURLOPT_FTP_USE_EPRT
TRUE to use EPRT (and LPRT) when doing active FTP downloads. Use FALSE to disable EPRT and LPRT and use PORT only.
Added in PHP 5.0.0.

CURLOPT_FTP_USE_EPSV
TRUE to first try an EPSV command for FTP transfers before reverting back to PASV. Set to FALSE to disable EPSV.

CURLOPT_FTPAPPEND
TRUE to append to the remote file instead of overwriting it.

CURLOPT_FTPASCII
An alias of CURLOPT_TRANSFERTEXT. Use that instead.

CURLOPT_FTPLISTONLY
TRUE to only list the names of an FTP directory.

CURLOPT_HEADER
啓用時會將頭文件的信息作爲數據流輸出。

CURLOPT_HTTPGET
啓用時會設置HTTP的method爲GET,因爲GET是默認是,所以只在被修改的情況下使用。

CURLOPT_HTTPPROXYTUNNEL
啓用時會通過HTTP代理來傳輸。

CURLOPT_MUTE
講curl函數中所有修改過的參數恢復默認值。

CURLOPT_NETRC
在連接建立以後,訪問~/.netrc文件獲取用戶名和密碼信息連接遠程站點。

CURLOPT_NOBODY
啓用時將不對HTML中的body部分進行輸出。

CURLOPT_NOPROGRESS
啓用時關閉curl傳輸的進度條,此項的默認設置爲true

CURLOPT_NOSIGNAL
啓用時忽略所有的curl傳遞給php進行的信號。在SAPI多線程傳輸時此項被默認打開。

CURLOPT_POST
啓用時會發送一個常規的POST請求,類型爲:application/x-www-form-urlencoded,就像表單提交的一樣。

CURLOPT_PUT
啓用時允許HTTP發送文件,必須同時設置CURLOPT_INFILE和CURLOPT_INFILESIZE

CURLOPT_RETURNTRANSFER
講curl_exec()獲取的信息以文件流的形式返回,而不是直接輸出。

CURLOPT_SSL_VERIFYPEER
FALSE to stop cURL from verifying the peer’s certificate. Alternate certificates to verify against can be specified with the CURLOPT_CAINFO option or a certificate directory can be specified with the CURLOPT_CAPATH option. CURLOPT_SSL_VERIFYHOST may also need to be TRUE or FALSE if CURLOPT_SSL_VERIFYPEER is disabled (it defaults to 2). TRUE by default as of cURL 7.10. Default bundle installed as of cURL 7.10.

CURLOPT_TRANSFERTEXT
TRUE to use ASCII mode for FTP transfers. For LDAP, it retrieves data in plain text instead of HTML. On Windows systems, it will not set STDOUT to binary mode.

CURLOPT_UNRESTRICTED_AUTH
在使用CURLOPT_FOLLOWLOCATION產生的header中的多個locations中持續追加用戶名和密碼信息,即使域名已發生改變。

CURLOPT_UPLOAD
啓用時允許文件傳輸

CURLOPT_VERBOSE
啓用時會彙報所有的信息,存放在STDERR或指定的CURLOPT_STDERR中

CURLOPT_BUFFERSIZE
每次獲取的數據中讀入緩存的大小,這個值每次都會被填滿。

CURLOPT_CLOSEPOLICY
不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST,還存在另外三個,但是curl暫時還不支持。.

CURLOPT_CONNECTTIMEOUT
在發起連接前等待的時間,如果設置爲0,則不等待。

CURLOPT_DNS_CACHE_TIMEOUT
設置在內存中保存DNS信息的時間,默認爲120秒。

CURLOPT_FTPSSLAUTH
The FTP authentication method (when is activated): CURLFTPAUTH_SSL (try SSL first), CURLFTPAUTH_TLS (try TLS first), or CURLFTPAUTH_DEFAULT (let cURL decide).

CURLOPT_HTTP_VERSION
設置curl使用的HTTP協議,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
設定上傳文件的大小

CURLOPT_LOW_SPEED_LIMIT
當傳輸速度小於CURLOPT_LOW_SPEED_LIMIT時,PHP會根據CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。

CURLOPT_LOW_SPEED_TIME
The number of seconds the transfer should be below CURLOPT_LOW_SPEED_LIMIT for PHP to consider the transfer too slow and abort.
當傳輸速度小於CURLOPT_LOW_SPEED_LIMIT時,PHP會根據CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。

CURLOPT_MAXCONNECTS
允許的最大連接數量,超過是會通過CURLOPT_CLOSEPOLICY決定應該停止哪些連接

CURLOPT_MAXREDIRS
指定最多的HTTP重定向的數量,這個選項是和CURLOPT_FOLLOWLOCATION一起使用的。

CURLOPT_PORT
一個可選的用來指定連接端口的量

CURLOPT_PROXYAUTH
The HTTP authentication method(s) to use for the proxy connection. Use the same bitmasks as described in CURLOPT_HTTPAUTH. For proxy authentication, only CURLAUTH_BASIC and CURLAUTH_NTLM are currently supported.

CURLOPT_PROXYPORT
The port number of the proxy to connect to. This port number can also be set in CURLOPT_PROXY.

CURLOPT_PROXYTYPE
Either CURLPROXY_HTTP (default) or CURLPROXY_SOCKS5.

CURLOPT_RESUME_FROM
在恢復傳輸時傳遞一個字節偏移量(用來斷點續傳)

CURLOPT_SSL_VERIFYHOST
1 to check the existence of a common name in the SSL peer certificate.
2 to check the existence of a common name and also verify that it matches the hostname provided.

CURLOPT_SSLVERSION
The SSL version (2 or 3) to use. By default PHP will try to determine this itself, although in some cases this must be set manually.

CURLOPT_TIMECONDITION
如果在CURLOPT_TIMEVALUE指定的某個時間以後被編輯過,則使用CURL_TIMECOND_IFMODSINCE返回頁面,如果沒有被修改過,並且CURLOPT_HEADER爲true,則返回一個”304 Not Modified”的header,CURLOPT_HEADER爲false,則使用CURL_TIMECOND_ISUNMODSINCE,默認值爲 CURL_TIMECOND_IFMODSINCE

CURLOPT_TIMEOUT
設置curl允許執行的最長秒數

CURLOPT_TIMEVALUE
設置一個CURLOPT_TIMECONDITION使用的時間戳,在默認狀態下使用的是CURL_TIMECOND_IFMODSINCE

CURLOPT_CAINFO
The name of a file holding one or more certificates to verify the peer with. This only makes sense when used in combination with CURLOPT_SSL_VERIFYPEER.

CURLOPT_CAPATH
A directory that holds multiple CA certificates. Use this option alongside CURLOPT_SSL_VERIFYPEER.

CURLOPT_COOKIE
設定HTTP請求中“Set-Cookie:”部分的內容。

CURLOPT_COOKIEFILE
包含cookie信息的文件名稱,這個cookie文件可以是Netscape格式或者HTTP風格的header信息。

CURLOPT_COOKIEJAR
連接關閉以後,存放cookie信息的文件名稱

CURLOPT_CUSTOMREQUEST
A custom request method to use instead of “GET” or “HEAD” when doing a HTTP request. This is useful for doing “DELETE” or other, more obscure HTTP requests. Valid values are things like “GET”, “POST”, “CONNECT” and so on; i.e. Do not enter a whole HTTP request line here. For instance, entering “GET /index.html HTTP/1.0\r\n\r\n” would be incorrect.
Note: Don’t do this without making sure the server supports the custom request method first.

CURLOPT_EGBSOCKET
Like CURLOPT_RANDOM_FILE, except a filename to an Entropy Gathering Daemon socket.

CURLOPT_ENCODING
header中“Accept-Encoding: ”部分的內容,支持的編碼格式爲:”identity”,”deflate”,”gzip”。如果設置爲空字符串,則表示支持所有的編碼格式

CURLOPT_FTPPORT
The value which will be used to get the IP address to use for the FTP “POST” instruction. The “POST” instruction tells the remote server to connect to our specified IP address. The string may be a plain IP address, a hostname, a network interface name (under Unix), or just a plain ‘-’ to use the systems default IP address.

CURLOPT_INTERFACE
在外部網絡接口中使用的名稱,可以是一個接口名,IP或者主機名。

CURLOPT_KRB4LEVEL
KRB4(Kerberos 4)安全級別的設置,可以是一下幾個值之一:”clear”,”safe”,”confidential”,”private”。默認的值爲”private”,設置爲null的時候表示禁用KRB4,現在KRB4安全僅能在FTP傳輸中使用。

CURLOPT_POSTFIELDS
在HTTP中的“POST”操作。如果要傳送一個文件,需要一個@開頭的文件名

CURLOPT_PROXY
設置通過的HTTP代理服務器

CURLOPT_PROXYUSERPWD
連接到代理服務器的,格式爲“[username]:[password]”的用戶名和密碼。

CURLOPT_RANDOM_FILE
設定存放SSL用到的隨機數種子的文件名稱

CURLOPT_RANGE
設置HTTP傳輸範圍,可以用“X-Y”的形式設置一個傳輸區間,如果有多個HTTP傳輸,則使用逗號分隔多個值,形如:”X-Y,N-M”。

CURLOPT_REFERER
設置header中”Referer: ” 部分的值。

CURLOPT_SSL_CIPHER_LIST
A list of ciphers to use for SSL. For example, RC4-SHA and TLSv1 are valid cipher lists.

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

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

CURLOPT_SSLCERTTYPE
The format of the certificate. Supported formats are “PEM” (default), “DER”, and “ENG”.

CURLOPT_SSLENGINE
The identifier for the crypto engine of the private SSL key specified in CURLOPT_SSLKEY.

CURLOPT_SSLENGINE_DEFAULT
The identifier for the crypto engine used for asymmetric crypto operations.

CURLOPT_SSLKEY
The name of a file containing a private SSL key.

CURLOPT_SSLKEYPASSWD
The secret password needed to use the private SSL key specified in CURLOPT_SSLKEY.
Note: Since this option contains a sensitive password, remember to keep the PHP script it is contained within safe.

CURLOPT_SSLKEYTYPE
The key type of the private SSL key specified in CURLOPT_SSLKEY. Supported key types are “PEM” (default), “DER”, and “ENG”.

CURLOPT_URL
需要獲取的URL地址,也可以在PHP的curl_init()函數中設置。

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

CURLOPT_USERPWD
傳遞一個連接中需要的用戶名和密碼,格式爲:“[username]:[password]”。

CURLOPT_HTTP200ALIASES
設置不再以error的形式來處理HTTP 200的響應,格式爲一個數組。

CURLOPT_HTTPHEADER
設置一個header中傳輸內容的數組。

CURLOPT_POSTQUOTE
An array of FTP commands to execute on the server after the FTP request has been performed.

CURLOPT_QUOTE
An array of FTP commands to execute on the server prior to the FTP request.

CURLOPT_FILE
設置輸出文件的位置,值是一個資源類型,默認爲STDOUT (瀏覽器)。

CURLOPT_INFILE
在上傳文件的時候需要讀取的文件地址,值是一個資源類型。

CURLOPT_STDERR
設置一個錯誤輸出地址,值是一個資源類型,取代默認的STDERR。

CURLOPT_WRITEHEADER
設置header部分內容的寫入的文件地址,值是一個資源類型。

CURLOPT_HEADERFUNCTION
設置一個回調函數,這個函數有兩個參數,第一個是curl的資源句柄,第二個是輸出的header數據。header數據的輸出必須依賴這個函數,返回已寫入的數據大小。

CURLOPT_PASSWDFUNCTION
設置一個回調函數,有三個參數,第一個是curl的資源句柄,第二個是一個密碼提示符,第三個參數是密碼長度允許的最大值。返回密碼的值。

CURLOPT_READFUNCTION
設置一個回調函數,有兩個參數,第一個是curl的資源句柄,第二個是讀取到的數據。數據讀取必須依賴這個函數。返回讀取數據的大小,比如0或者EOF。

CURLOPT_WRITEFUNCTION
設置一個回調函數,有兩個參數,第一個是curl的資源句柄,第二個是寫入的數據。數據寫入必須依賴這個函數。返回精確的已寫入數據的大小

curl_error()函數的作用是返回一個包含當前會話錯誤信息的字符串。
curl_errno()函數的作用是返回一個包含當前會話錯誤信息的數字編號。

curl_multi_init()函數的作用是初始化一個curl批處理句柄資源。
curl_multi_add_handle()函數的作用是向curl批處理會話中添加單獨的curl句柄資源。curl_multi_add_handle()函數有兩個參數,第一個參數表示一個curl批處理句柄資源,第二個參數表示一個單獨的curl句柄資源。
curl_multi_exec()函數的作用是解析一個curl批處理句柄,curl_multi_exec()函數有兩個參數,第一個參數表示一個批處理句柄資源,第二個參數是一個引用值的參數,表示剩餘需要處理的單個的curl句柄資源數量。
curl_multi_remove_handle()函數表示移除curl批處理句柄資源中的某個句柄資源,curl_multi_remove_handle()函數有兩個參數,第一個參數表示一個curl批處理句柄資源,第二個參數表示一個單獨的curl句柄資源。
curl_multi_close()函數的作用是關閉一個批處理句柄資源。

curl_multi_getcontent()函數的作用是在設置了CURLOPT_RETURNTRANSFER的情況下,返回獲取的輸出的文本流。

curl_multi_info_read()函數的作用是獲取當前解析的curl的相關傳輸信息。

curl_multi_select()
Get all the sockets associated with the cURL extension, which can then be “selected”


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章