PHP 使用 CURL 詳解

語言: CN / TW / HK

點選進入“PHP開源社群”    

免費獲取進階面試、文件、影片資源

使用CURL傳送請求的基本流程

使用CURL的PHP擴充套件完成一個HTTP請求的傳送一般有以下幾個步驟:

  1. 初始化連線控制代碼;

  2. 設定CURL選項;

  3. 執行並獲取結果;

  4. 釋放VURL連線控制代碼。

下面的程式片段是使用CURL傳送HTTP的典型過程

<?php

// 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請求。上述程式碼片段中使用了三個重要的選項:

  1. CURLOPT_URL  指定請求的URL;

  2. CURLOPT_RETURNTRANSFER 設定為1表示稍後執行的curl_exec函式的返回是URL的返回字串,而不是把返回字串定向到標準輸出並返回TRUE;

  3. CURLLOPT_HEADER設定為0表示不返回HTTP頭部資訊。

CURL的選項還有很多,可以到PHP的官方網站(http://www.php.net/manual/en/function.curl-setopt.php)上檢視CURL支援的所有選項列表。

獲取CURL請求的輸出資訊

在curl_exec()函式執行之後,可以使用curl_getinfo()函式獲取CURL請求輸出的相關資訊,示例程式碼如下:

<?php

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,具體程式碼如下:

<?php

**

*@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,程式碼如下:

<?php

/**

** @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請求資料即可。

如果你年滿18週歲以上,又覺得學【PHP】太難?想嘗試其他程式語言,那麼我推薦你學Python,現有價值499元Python零基礎課程限時免費領取,限10個名額!

掃描二維碼-免費領取

點選“檢視原文”獲取更多