PHP使用CURL詳解

CURL是一個很是強大的開源庫，支持不少協議，包括HTTP、FTP、TELNET等，咱們使用它來發送HTTP請求。它給我 們帶來的好處是能夠經過靈活的選項設置不一樣的HTTP協議參數，而且支持HTTPS。CURL能夠根據URL前綴是「HTTP」 仍是「HTTPS」自動選擇是否加密發送內容。

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

使用CURL的PHP擴展完成一個HTTP請求的發送通常有如下幾個步驟：

1. 初始化鏈接句柄；
2. 設置CURL選項；
3. 執行並獲取結果；
4. 釋放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請求。上述代碼片斷中使用了三個重要的選項：
  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請求輸出的相關信息，示例代碼以下：

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請求數據便可秀。

 

原文地址：http://www.devdo.net/php-curl.html