CURL是一個非常強大的開源庫,支持很多協議,包括HTTP、FTP、TELNET等,我們使用它來發送HTTP請求。它給我 們帶來的好處是可以通過靈活的選項設置不同的HTTP協議參數,並且支持HTTPS。CURL可以根據URL首碼是“HTTP” 還是“HTTPS”自動選擇是否加密發送內容。 使用CUR ...
CURL是一個非常強大的開源庫,支持很多協議,包括HTTP、FTP、TELNET等,我們使用它來發送HTTP請求。它給我 們帶來的好處是可以通過靈活的選項設置不同的HTTP協議參數,並且支持HTTPS。CURL可以根據URL首碼是“HTTP” 還是“HTTPS”自動選擇是否加密發送內容。
使用CURL發送請求的基本流程
使用CURL的PHP擴展完成一個HTTP請求的發送一般有以下幾個步驟:
- 初始化連接句柄;
- 設置CURL選項;
- 執行並獲取結果;
- 釋放VURL連接句柄。
下麵的程式片段是使用CURL發送HTTP的典型過程
// 1. 初始化
$ch = curl_init();
// 2. 設置選項,包括URL
curl_setopt($ch,CURLOPT_URL,"http://www.devdo.net");
curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
curl_setopt($ch,CURLOPT_HEADER,0);
// 3. 執行並獲取HTML文檔內容
$output = curl_exec($ch);
if($output === FALSE ){
echo "CURL Error:".curl_error($ch);
}
// 4. 釋放curl句柄
curl_close($ch);
上述代碼中使用到了四個函數
- curl_init() 和 curl_close() 分別是初始化CURL連接和關閉CURL連接,都比較簡單。
- curl_exec() 執行CURL請求,如果沒有錯誤發生,該函數的返回是對應URL返回的數據,以字元串表示滿意;如果發生錯誤,該函數返回 FALSE。需要註意的是,判斷輸出是否為FALSE用的是全等號,這是為了區分返回空串和出錯的情況。
- CURL函數庫里最重要的函數是curl_setopt(),它可以通過設定CURL函數庫定義的選項來定製HTTP請求。上述代碼片段中使用了三個重要的選項:
- CURLOPT_URL 指定請求的URL;
- CURLOPT_RETURNTRANSFER 設置為1表示稍後執行的curl_exec函數的返回是URL的返回字元串,而不是把返回字元串定向到標準輸出並返回TRUE;
- CURLLOPT_HEADER設置為0表示不返回HTTP頭部信息。
CURL的選項還有很多,可以到PHP的官方網站(http://www.php.net/manual/en/function.curl-setopt.php)上查看CURL支持的所有選項列表。
獲取CURL請求的輸出信息
在curl_exec()函數執行之後,可以使用curl_getinfo()函數獲取CURL請求輸出的相關信息,示例代碼如下:
curl_exec($ch);
$info = curl_getinfo($sh);
echo ' 獲取 '.$info['url'].'耗時'.$info['total_time'].'秒';
上述代碼中curl_getinfo返回的是一個關聯數組,包含以下數據:
- url:網路地址。
- content_type:內容編碼。
- http_code:HTTP狀態碼。
- header_size:header的大小。
- request_size:請求的大小。
- filetime:文件創建的時間。
- ssl_verify_result:SSL驗證結果。
- redirect_count:跳轉計數。
- total_time:總耗時。
- namelookup_time:DNS查詢耗時。
- connect_time:等待連接耗時。
- pretransfer_time:傳輸前準備耗時。
- size_uplpad:上傳數據的大小。
- size_download:下載數據的大小。
- speed_download:下載速度。
- speed_upload:上傳速度。
- download_content_length:下載內容的長度。
- upload_content_length:上傳內容的長度。
- starttransfer_time:開始傳輸的時間表。
- redirect_time:重定向耗時。
curl_getinfo()函數還有一個可選擇參數$opt,通過這個參數可以設置一些常量,對應到上術這個欄位,如果設置了第二個參數,那麼返回的只有指定的信息。例如設置$opt為CURLINFO_TOTAL_TIME,則curl_getinfo()函數只返回total_time,即總傳輸消耗的時間,在只需要關註某些傳輸信息時,設置$opt參數很有意義。
使用CURL發送GET請求
如何使用CURL來發送GET請求,發送GET請求的關鍵是拼裝格式正確的URL。請求地址和GET數據由一個“?”分割,然後GET變數的名稱和值用“=”分隔,各個GET名稱和值由“&”連接。PHP為我們提供了一個函數專門用來拼裝GET請求和數據部分——http_build_query,該函數接受一個關聯數組,返回由該關聯數據描述的GET請求字元串。使用這個函數,結合CURL發送HTTP請求的一般流程,我們封閉了一個發送GET請求的函數——doCurlGetRequest,具體代碼如下:
**
*@desc 封閉curl的調用介面,get的請求方式。
*/
function doCurlGetRequest($url,$data,$timeout = 5){
if($curl == "" || $timeout <= 0){
return false;
}
$url = $url.'?'.http_bulid_query($data);
$con = curl_init((string)$url);
curl_setopt($con, CURLOPT_HEADER, false);
curl_setopt($con, CURLOPT_RETURNTRANSFER,true);
curl_setopt($con, CURLOPT_TIMEOUT, (int)$timeout);
return curl_exec($con);
}
這個函數把使用http_build_query 拼裝好的帶GET參數的URL傳給curl_init函數,然後使用CURL發送HTTP請求。
使用CURL發送POST請求
可以使用CURL提供的選項CURLOPT_POSTFIELDS,設置該選項為POST字元串數據就可以把請求放在正文中。同樣我們實現了一個發送POST請求的函數——doCurlPostRequest,代碼如下:
/**
** @desc 封裝 curl 的調用介面,post的請求方式
**/
function doCurlPostRequest($url,$requestString,$timeout = 5){
if($url == '' || $requestString == '' || $timeout <=0){
return false;
}
$con = curl_init((string)$url);
curl_setopt($con, CURLOPT_HEADER, false);
curl_setopt($con, CURLOPT_POSTFIELDS, $requestString);
curl_setopt($con, CURLOPT_POST,true);
curl_setopt($con, CURLOPT_RETURNTRANSFER,true);
curl_setopt($con, CURLOPT_TIMEOUT,(int)$timeout);
return curl_exec($con);
}
上面代碼中除了設置CURLOPT_POSTFIELDS外,我們還設置了CURL_POST為true,標識這個請求是一個POST請求。在POST請求中也是可以傳輸GET數據的,只需要在URL中拼裝GET請求數據即可。