php中的curl使用入門教程和常見用法執行個體

 起先cURL是做為一種命令列工具設計出來的，比較幸運的是，php也支援cURL了。通過cURL這個利器，我們能在php程式中自由地發送HTTP請求到某個url來擷取或者提交資料，並且支援其它多種協議，比如FTP，Telnet以及SMTP等。在這篇博文中，我將簡述下，在php中具體怎麼使用cURL來處理一些事情。

一、curl的優勢 你也許會說，在php中可以很容易的擷取某個url的內容，只要通過file_get_contents，file或者readfile函數就能輕鬆實現，根本不必使用cURL:  代碼如下:         $content = file_get_contents("http://www.360weboy.com");        $lines = file("http://www.360weboy.com");        readfile("http://www.360weboy.com"); 沒錯，以上函數在某些情況下使用起來確實很方便，但是我感覺這幾個函數不夠靈活，也沒法進行錯誤處理。而且，如果遇到要在php程式中向某個伺服器提交表單資料，上傳檔案，處理cookies或者認證等任務時，以上三個函數根本無法勝任。這個時候，cURL就體現它的價值了。 cURl不但支援很多的網路通訊協定，而且提供了關於url請求的具體資訊，很強大！ 二、curl的簡單使用步驟 要使用cURL來發送url請求，具體步驟大體分為以下四步： 1.初始化2.佈建要求選項3.執行一個cURL會話並且擷取相關回複4.釋放cURL控制代碼,關閉一個cURL會話   代碼如下:            // 1. 初始化一個cURL會話        $ch = curl_init();         // 2. 佈建要求選項, 包括具體的url        curl_setopt($ch, CURLOPT_URL, "http://www.360weboy.com");        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);        curl_setopt($ch, CURLOPT_HEADER, 0);         // 3. 執行一個cURL會話並且擷取相關回複        $response = curl_exec($ch);         // 4. 釋放cURL控制代碼,關閉一個cURL會話        curl_close($ch);    cURL之所以強大，正是體現在第二個步驟中。你可以通過curl_setopt靈活地佈建要求選項，這裡面有很多的可選項，具體可以參考http://cn2.php.net/manual/zh/function.curl-setopt.php 三、錯誤處理 在上述代碼中，你也可以增加錯誤處理的代碼：  代碼如下:         $response = curl_exec($ch);         if ($response  === FALSE) {          echo "cURL 具體出錯資訊: " . curl_error($ch);        }     注意了，在做上述判斷時務必要使用===，因為請求的回複可能是Null 字元串，curl在請求出錯的情況下回返回FALSE值，所以我們必須使用===，而不是==。 四、擷取curl請求的具體資訊 在執行一個cURL請求後，你也可以使用curl_getinfo擷取該請求的具體資訊:  代碼如下:         curl_exec($ch);        $curl_info= curl_getinfo($ch);         echo "收到的http回複的code為： {$curl_info['http_code']}";    上述$curl_info是一個關聯陣列，可以從中擷取很多的具體請求資訊。參考http://cn2.php.net/manual/zh/function.curl-getinfo.php 五、使用curl發送post請求 我們在前面說過，在向某個url發送get請求的話，沒有必要使用cURL來發送get請求，可以使用比較便捷的file_get_contents函數來完成請求。但是，一般地，我們在提交某個表單的時候，資料是通過post請求的內容地區來提交的，而不是通過url參數來傳遞的, 這種情況下，我們應該使用靈活的cURL來類比發送post請求。 現在，讓我們使用cURL來類比發送一個post請求到post.php指令碼，提交幾個資料到post.php，然後在post.php中輸出post請求中的資料。範例程式碼如下:  代碼如下:        $url = "http://www.360weboy.me/post.php";         $post_data = array (          "blog_name" => "360weboy",          "blog_url" => "http://www.360weboy.com",          "action" => "Submit"        );         $ch = curl_init();        curl_setopt($ch, CURLOPT_URL, $url);        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);         // 佈建要求為post類型        curl_setopt($ch, CURLOPT_POST, 1);        // 添加post資料到請求中        curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);         // 執行post請求，獲得回複        $response= curl_exec($ch);        curl_close($ch);         echo $response;    以上請求發送到post.php中後，通過print_r($_POST)輸出後，以上範例程式碼會輸出如下回複： 代碼如下:         Array        (            [blog_name] => 360weboy            [blog_url] => http://www.360weboy.com            [action] => Submit        )    正如我們看到的，cURL成功發送post請求到post.php，提交了一些資料，並且收到了相應的來自post.php的回複，最後輸出回複。上例雖然簡單，但是充分示範了cURL發送post請求的便捷及強大之處，你可以在curl_setopt上做文章。 六、檔案上傳 下面來看下如果通過cURL發送post請求來實現檔案上傳。就拿深入淺出PHP下的檔案上傳中的檔案上傳例子來示範，在深入淺出php下的檔案上傳中，是通過表單的提交來實現檔案上傳的，那麼通過cURL怎麼來實現呢?   代碼如下:          $url = "http://www.360weboy.me/upload.php";         $post_data = array (          "attachment" => "@E:/jackblog/boy.jpg"        );         //初始化cURL會話        $ch = curl_init();         //佈建要求的url        curl_setopt($ch, CURLOPT_URL, $url);        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);         //設定為post請求類型        curl_setopt($ch, CURLOPT_POST, 1);         //設定具體的post資料        curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);         $response = curl_exec($ch);        curl_close($ch);         print_r($response);     通過以上範例程式碼，可以將我本地機器上的boy.jpg上傳到本機伺服器的upload.php中，如果在upload.php輸出上傳的具體資訊的話，以上範例程式碼最後的輸出的回複為：  代碼如下:            Array        (            [attachment] => Array                (                    [name] => boy.jpg                    [type] => application/octet-stream                    [tmp_name] => D:xampptmpphpF27D.tmp                    [error] => 0                    [size] => 11490                )         )    由此可見，如果你要通過cURL來上傳檔案的話，只需要將上傳的檔案路徑作為post資料設定到curl請求中，並且在路徑前面加上@符合。 七、檔案下載 上述將了檔案上傳，同樣的也可以使用curl來自動地完成檔案的下載以及儲存。有一點要補充下，在執行一個curl請求時，如果你需要擷取返回的內容，而不是直接輸出返回的內容的話，別忘記使用下面的代碼設定，因為curl的預設是輸出請求的回複內容: 代碼如下:         curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);    假如在360weboy的伺服器根目錄下面有一個test.zip檔案，我們需要將其下載下來，並且儲存到本地檔案中，就可以嘗試使用下面的代碼來實現： 代碼如下:         //佈建要求的下載檔案的url        $url  = 'http://www.360weboy.com/test.zip';         //儲存到本地的檔案路徑        $path = 'local/path/to/test.zip';         //初始化請求，佈建要求，擷取回複,關閉會話        $ch = curl_init($url);        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);         $data = curl_exec($ch);         curl_close($ch);         //將檔案內容寫入本地檔案        file_put_contents($path, $data);    注意：我以上省略了錯誤處理方面的代碼，只是簡單做個樣本, 在實際中，你還需要通過curl_getinfo函數來進行錯誤處理! 上述代碼對於下載比較大型的檔案是不適用的，因為需要先將檔案讀取到記憶體中，等所有內容都讀取完畢，然後再寫入到本地硬碟中。即使php中設定的memory limit非常大，這種情況對效能的影響也是很大的。所以，我們對於大型檔案的下載，應該讓curl來接管這個任務，實現邊下載，邊寫入的處理，這樣的話，就沒什麼問題了。請看下述代碼: 代碼如下:         $url  = 'http://www.360weboy.com/test.zip';        $path = 'local/path/to/test.zip';         // 開啟本地檔案        $fp = fopen($path, 'w');         // 告訴curl本地檔案控制代碼        $ch = curl_init($url);        curl_setopt($ch, CURLOPT_FILE, $fp);         curl_exec($ch);         curl_close($ch);        fclose($fp);    在上述代碼中，我們先開啟個本地檔案，並將檔案控制代碼設定到curl中，然後讓curl一邊讀取遠端資料，一邊寫入到本地檔案中。因為我們不需要在程式中擷取遠程回複的內容了，所以只要執行請求就可以。 八、http 驗證 如果伺服器端需要驗證請求，可以通過類似一下範例程式碼來實現: 代碼如下:         $url = "http://www.360weboy.com/users/";        $ch = curl_init();        curl_setopt($ch, CURLOPT_URL, $url);        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);         // 設定使用者名稱以及密碼        curl_setopt($ch, CURLOPT_USERPWD, "username:password");         // 設定重導向        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);        curl_setopt($ch, CURLOPT_UNRESTRICTED_AUTH, 1);         $response = curl_exec($ch);        curl_close($ch);    九、通過代理髮送請求 cURL還可以通過Proxy 伺服器來向發送請求，請看一下範例程式碼:代碼如下:         $ch = curl_init();        curl_setopt($ch, CURLOPT_URL,'http://www.360weboy.com');        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);         // 設定代理ip地址        curl_setopt($ch, CURLOPT_PROXY, '222.73.173.50:8080');         // 要驗證的話，這裡設定使用者名稱以及密碼        curl_setopt($ch, CURLOPT_PROXYUSERPWD,'username:password');         $response = curl_exec($ch);        curl_close ($ch);   十、發送json資料 最後，我們來看下通過cURL來想伺服器端發送json資料。具體的代碼如下：   代碼如下:           $url = 'http://www.360weboy.me/json.php';         // 建立json字串        $data = array('site' => '360weboy', 'url' => 'http://www.360weboy.com','email'=>'360weboy@gmail.com');        $json_string = json_encode($data);         $ch=curl_init($url);        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);         // 通過post請求發送上述json字串        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");        curl_setopt($ch, CURLOPT_POSTFIELDS, array('data'=>$json_string));         $response = curl_exec($ch);        curl_close($ch);         echo $response;    大家可以看到，上述請求是發送到我的本機伺服器的json.php下，我在該檔案中使用json_decode來將接受到的json字串轉換為對象，然後輸出其中的email欄位，代碼如下: 代碼如下:         $json_data = json_decode($_POST['data']);         echo $json_data->email;     在上述代碼中接受的json字串為: 代碼如下:         '{"site":"360weboy","url":"http://www.360weboy.com","email":"360weboy@gmail.com"}'    經過json_decode以後，就轉換為php中的資料格式，成為了一個對象，所以可以通過$json_data->email來訪問其中email欄位的值，最後也就是輸出360weboy@gmail.com。你可以使用上述代碼測試一下。 如果通過以下php數組產生json字串的話: 代碼如下:         $data = array('360weboy', 'http://www.360weboy.com', '360weboy@gmail.com');    所產生的json字串如下： 代碼如下:         '["360weboy","http://www.360weboy.com","360weboy@gmail.com"]'    上述json字串在經過json_decode處理後，就會變成php中的數組格式，如果要擷取email的話，就可以通過$json_data[2]來訪問。 十一、總結 在這篇博文中只是列舉了一些cURL的用途，其中範例程式碼是比較簡單的。但是，相信你看完後應該有使用cURL的衝動了吧! 那就自己去找相關資料，手冊進行測試吧！ 好了，就寫到這裡吧！謝謝你的耐心閱讀！