PHP 使用 CURL 詳解

語言: CN / TW / HK

時間 2022-09-21 18:14:57 PHP開源社群

主題: curl PHP

點選進入“PHP開源社群”

免費獲取進階面試、文件、視訊資源

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

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

初始化連線控制代碼；
設定CURL選項；
執行並獲取結果；
釋放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請求。上述程式碼片段中使用了三個重要的選項：

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請求輸出的相關資訊，示例程式碼如下：

<?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個名額！

▲ 掃描二維碼-免費領取

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

「其他文章」