PHP 中的 cURL 庫

happen 發(fā)布于2019-06-28 18:42 / 406人閱讀

摘要：支持創(chuàng)建的庫，能夠連接通訊各種服務(wù)器使用各種協(xié)議。目前支持的協(xié)議有。在一些復(fù)雜的請求中，不能夠設(shè)置請求頭代理認(rèn)證等相關(guān)信息，更不能向某個(gè)服務(wù)器提交表單數(shù)據(jù)，上傳文件。文件類型可在文件名后以的格式指定。

概述簡介

在設(shè)計(jì)之初，cURL （Client URL Library）是一種作為使用 URL 語法傳輸數(shù)據(jù)的命令行工具。通過 cURL 庫，我們可以在 PHP 腳本中自由地使用某種協(xié)議來獲取或者提交數(shù)據(jù)，比如獲取 HTTP 請求數(shù)據(jù)。簡單的來說，cURL 是客戶端向服務(wù)器請求資源的工具。

PHP 支持 Daniel Stenberg 創(chuàng)建的 libcurl 庫，能夠連接通訊各種服務(wù)器、使用各種協(xié)議。libcurl 目前支持的協(xié)議有 http、https、ftp、gopher、telnet、dict、file、ldap。 libcurl 同時(shí)支持 HTTPS 證書、HTTP POST、HTTP PUT、 FTP 上傳(也能通過 PHP 的 FTP 擴(kuò)展完成)、HTTP 基于表單的上傳、代理、cookies、用戶名+密碼的認(rèn)證。

優(yōu)勢

在 PHP 中，想要獲取某個(gè) URL 的內(nèi)容其實(shí)很簡單，有多種實(shí)現(xiàn)方法，比如使用 file_get_contents() 函數(shù)：


雖然 file_get_contents() 函數(shù)使用起來很方便，但是不夠靈活，也沒法進(jìn)行錯(cuò)誤處理。在一些復(fù)雜的請求中，不能夠設(shè)置請求頭、Cookie、代理、認(rèn)證等相關(guān)信息，更不能向某個(gè)服務(wù)器提交表單數(shù)據(jù)，上傳文件。
cURl 庫不但支持豐富的網(wǎng)絡(luò)協(xié)議，而且提供了設(shè)置各種 URL 請求參數(shù)的方法，功能強(qiáng)大。cURL 的使用場景有很多，比如訪問網(wǎng)頁資源，獲取 WebService 接口數(shù)據(jù)、下載 FTP 服務(wù)器文件。
使用
基本步驟
要使用 cURL 來發(fā)送 URL 請求，步驟大體分為以下四步：

初始化 cURL 會(huì)話；
設(shè)置請求選項(xiàng)；
執(zhí)行 cURL 會(huì)話；
關(guān)閉 cURL 會(huì)話。

// 1. 初始化 cURL 會(huì)話
$ch = curl_init();

// 2. 設(shè)置請求選項(xiàng)
curl_setopt($ch, CURLOPT_URL, "https://segmentfault.com");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); # 獲取的信息以字符串返回，而不是直接輸出
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0); # 禁止 cURL 驗(yàn)證對等證書，從而支持 HTTPS 訪問

// 3. 執(zhí)行 cURL 會(huì)話
$response = curl_exec($ch);
var_dump($response);

// 4. 關(guān)閉 cURL 會(huì)話
curl_close($ch);
cURL 主要通過 curl_setopt() 函數(shù)設(shè)置請求選項(xiàng)，具體的每個(gè)選項(xiàng)說明請見 http://php.net/manual/zh/func...

錯(cuò)誤處理
通過 curl_error() 函數(shù)可以查看 cURL 會(huì)話錯(cuò)誤詳情，而 curl_getinfo() 函數(shù)可以查看響應(yīng)信息。因此，通過這兩個(gè)函數(shù)我們可以實(shí)現(xiàn)一個(gè)簡單的錯(cuò)誤處理程序，比如我們現(xiàn)在訪問一個(gè)不存在的 URL 地址：

實(shí)戰(zhàn)案例
1. POST 請求
使用 cURL 模擬發(fā)送 POST 請求：
 $url,
        CURLOPT_RETURNTRANSFER => 1, # 獲取的信息以字符串返回
        CURLOPT_POST => 1,           # 發(fā)送 POST 請求
        CURLOPT_POSTFIELDS => $data, # POST 請求數(shù)據(jù) 
    ]);

    $response = curl_exec($ch);
    
    curl_close($ch);
    
    return $response;
}

$url  = "http://localhost/test.php";
$data = ["id" => 1, "username" => "jochen"];
echo curl_post($url, $data);
2. 文件上傳
CURLOPT_POSTFIELDS：全部數(shù)據(jù)使用 HTTP 協(xié)議中的 "POST" 操作來發(fā)送。 要發(fā)送文件，在文件名前面加上@前綴并使用完整路徑。 文件類型可在文件名后以 ";type=mimetype" 的格式指定。 這個(gè)參數(shù)可以是 urlencoded 后的字符串，類似"val1=1&val2=2&..."，也可以使用一個(gè)以字段名為鍵值，字段數(shù)據(jù)為值的數(shù)組。
通過 cURL 發(fā)送 POST 請求來實(shí)現(xiàn)文件上傳：
 $url,
        CURLOPT_RETURNTRANSFER => 1, # 獲取的信息以字符串返回
        CURLOPT_POST => 1,           # 發(fā)送 POST 請求
        CURLOPT_POSTFIELDS => $data, # POST 請求數(shù)據(jù) 
    ]);

    $response = curl_exec($ch);
    
    curl_close($ch);
    
    return $response;
}

$url  = "http://localhost/test.php";
$data = ["id" => 1, "file" => "@/root/image/boy.jpg"];
echo curl_post($url, $data);
3. 文件下載
其實(shí)，文件下載與普通 GET 請求是一樣的，只是文件下載把返回內(nèi)容保存至文件中，而不是簡單的輸出。配合 file_put_contents() 函數(shù)實(shí)現(xiàn)文件下載：
 $url,
        CURLOPT_RETURNTRANSFER => 1, # 獲取的信息以字符串返回
    ]);

    $response = curl_exec($ch);
    
    curl_close($ch);
    
    return file_put_contents($path, $response);
}

curl_download("http://localhost/boy.jpg", "./boy.jpg");
4. HTTP 認(rèn)證
如果服務(wù)器端需要驗(yàn)證請求，設(shè)置 CURLOPT_USERPWD 參數(shù)即可：
 $url,
        CURLOPT_USERPWD => "$user:$passwd", # 格式為："[username]:[password]"
        CURLOPT_RETURNTRANSFER => 1
    ]);
    
    $result = curl_exec($ch);
    
    curl_close($ch);
    
    return $result;
}

echo curl_auth("http://localhost", "jochen", "password");
5. 模擬登錄
這里主要展示模擬登錄使用了 Cookie 來保持登錄狀態(tài)的應(yīng)用。首先我們需要通過賬號密碼登錄獲取到 Cookie 數(shù)據(jù)，然后利用已登錄的 Cookie 獲取頁面數(shù)據(jù)：
 $url,
        CURLOPT_POST => 1,           # 發(fā)送 POST 請求
        CURLOPT_POSTFIELDS => $data, # POST 請求數(shù)據(jù) 
        CURLOPT_COOKIEJAR => $cookie # 將 cookie 信息保存至文件中
        CURLOPT_RETURNTRANSFER => 1, # 獲取的信息以字符串返回
    ]);

    $response = curl_exec($ch);
    
    curl_close($ch);
    
    return $response;
}

// 獲取頁面數(shù)據(jù)
function curl_content($url, $cookie) {
    $ch = curl_init(); 
    
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_COOKIEFILE => $cookie # 加載包含 Cookie 數(shù)據(jù)的文件
        CURLOPT_RETURNTRANSFER => 1, # 獲取的信息以字符串返回
    ]);

    $response = curl_exec($ch);
    
    curl_close($ch);
    
    return $response;
}

$post = ["username" => "jochen", "password" => "123456"];
$cookie = "./cookie.txt";
if (curl_login("http://localhost/login", $post,  $cookie)) {
    echo curl_content("http://localhost", $cookie);
}
cURL 封裝庫
PHP Curl Class 是一個(gè)編寫得很好的 cURL 封裝庫，它可以非常方便地發(fā)送 HTTP 請求并與任何類型的 Web API 集成。PHP Curl Class 封裝庫適用于 PHP 5.3，5.4，5.5，5.6，7.0，7.1 和 HHVM。這個(gè)庫是眾所周知的，并提供了一個(gè)非常簡單的語法：
get("https://www.example.com/");

if ($curl->error) {
    echo "Error: " . $curl->errorCode . ": " . $curl->errorMessage . "
";
} else {
    echo "Response:" . "
";
    var_dump($curl->response);
}
參考文章：

Client URL 庫
php中的curl使用入門教程和常見用法實(shí)例
在PHP中使用CURL，“撩”服務(wù)器只需幾行——php curl詳細(xì)解析和常見大坑
Top 7: Best Curl Wrapper Libraries for PHP