libcurl庫是一個(gè)實(shí)現(xiàn)了各種客戶端協(xié)議的網(wǎng)絡(luò)編程庫。目前它支持12種以上的協(xié)議，包括 FTP、HTTP、Telnet以及其他安全變體。
如果您有 10 年以上的腳本語言經(jīng)驗(yàn)，您就會(huì)注意到它們的標(biāo)記有很大的變化。Python、Ruby、Perl 等這些腳本語言不僅包含套接字層（C 或 C++ 中也有），還包含了應(yīng)用層協(xié)議 API。這些腳本語言合并了高級功能，可以創(chuàng)建 HTTP 服務(wù)器或客戶端。libcurl 庫為 C 和 C++ 之類的語言添加了類似的功能，但是它可以在不同的語言之間移植。在所有它支持的語言中都能找到與 libcurl 相當(dāng)?shù)男袨?，但是由于這些語言的差異很大（設(shè)想一下 C 和 Scheme），提供這些行為的方式也很不相同。
libcurl 庫以 API 的形式封裝各種客戶端協(xié)議，因此它可以被高級語言使用（如今已超過 30 種）。下面的示例研究使用 C 構(gòu)建的簡單 HTTP 客戶端（適合構(gòu)建 Web 爬行器）。
基于 C 的 HTTP 客戶端
C API 在 libcurl 功能上提供了兩個(gè) API。easy 接口是一個(gè)簡單的同步 API（意味著當(dāng)您使用請求調(diào)用 libcurl 時(shí)，將能夠滿足您的請求，直到完成或發(fā)生錯(cuò)誤）。多接口可以進(jìn)一步控制 libcurl，您的應(yīng)用程序可以執(zhí)行多個(gè)同步傳輸，并控制 libcurl 何時(shí)何地移動(dòng)數(shù)據(jù)。
該示例使用 easy 接口。該 API 還能控制數(shù)據(jù)移動(dòng)過程（使用回調(diào)），但正如其名稱所示，使用起來非常簡單。清單 3 提供了 HTTP 的 C 語言示例。
使用 libcurl easy 接口的 C HTTP 客戶端
- #include <stdio.h>
- #include <string.h>
- #include <curl/curl.h>
-
- #define MAX_BUF 65536
-
- char wr_buf[MAX_BUF+1];
- int wr_index;
-
- /*
- * Write data callback function (called within the context of
- * curl_easy_perform.
- */
- size_t write_data( void *buffer, size_t size, size_t nmemb, void *userp )
- {
- int segsize = size * nmemb;
-
- /* Check to see if this data exceeds the size of our buffer. If so,
- * set the user-defined context value and return 0 to indicate a
- * problem to curl.
- */
- if ( wr_index + segsize > MAX_BUF ) {
- *(int *)userp = 1;
- return 0;
- }
-
- /* Copy the data from the curl buffer into our buffer */
- memcpy( (void *)&wr_buf[wr_index], buffer, (size_t)segsize );
-
- /* Update the write index */
- wr_index += segsize;
-
- /* Null terminate the buffer */
- wr_buf[wr_index] = 0;
-
- /* Return the number of bytes received, indicating to curl that all is okay */
- return segsize;
- }
-
-
- /*
- * Simple curl application to read the index.html file from a Web site.
- */
- int main( void )
- {
- CURL *curl;
- CURLcode ret;
- int wr_error;
-
- wr_error = 0;
- wr_index = 0;
-
- /* First step, init curl */
- curl = curl_easy_init();
- if (!curl) {
- printf("couldn't init curl ");
- return 0;
- }
-
- /* Tell curl the URL of the file we're going to retrieve */
- curl_easy_setopt( curl, CURLOPT_URL, "www.exampledomain.com" );
-
- /* Tell curl that we'll receive data to the function write_data, and
- * also provide it with a context pointer for our error return.
- */
- curl_easy_setopt( curl, CURLOPT_WRITEDATA, (void *)&wr_error );
- curl_easy_setopt( curl, CURLOPT_WRITEFUNCTION, write_data );
-
- /* Allow curl to perform the action */
- ret = curl_easy_perform( curl );
-
- printf( "ret = %d (write_error = %d) ", ret, wr_error );
-
- /* Emit the page if curl indicates that no errors occurred */
- if ( ret == 0 ) printf( "%s ", wr_buf );
-
- curl_easy_cleanup( curl );
-
- return 0;
- }
最上方是必需的 include文件，包括 cURL 根文件。接下來，我定義了兩個(gè)用于傳輸?shù)淖兞?。第一個(gè)變量是 wr_buf，表示將在其中寫入傳入數(shù)據(jù)的緩沖區(qū)。wr_index表示緩沖區(qū)的當(dāng)前寫入索引。
轉(zhuǎn)到 main函數(shù)，該函數(shù)使用 easy API 進(jìn)行設(shè)置。所有 cURL 調(diào)用都通過維護(hù)特定請求狀態(tài)的句柄進(jìn)行操作。這稱為 CURL指針引用。本例還創(chuàng)建一個(gè)特殊的返回碼，稱為 CURLcode。在使用任何 libcurl 函數(shù)之前，您需要調(diào)用 curl_easy_init獲取 CURL句柄。接下來，注意 curl_easy_setopt調(diào)用的數(shù)量。它們?yōu)樘囟ǖ牟僮髋渲镁浔τ谶@些調(diào)用，您提供句柄、命令和選項(xiàng)。首先，本例使用 CURLOPT_URL指定要獲取的 URL。然后，它使用 CURL_WRITEDATA提供一個(gè)上下文變量（在本例中，它是內(nèi)部的 write 錯(cuò)誤變量）。最后，它使用 CURLOPT_WRITEFUNCTION指定數(shù)據(jù)可用時(shí)應(yīng)該調(diào)用的函數(shù)。在啟動(dòng) API 之后，API 將使用它讀取的數(shù)據(jù)多次調(diào)用該函數(shù)。
要開始傳輸，調(diào)用 curl_easy_perform。它的工作是根據(jù)之前的配置執(zhí)行傳輸。調(diào)用該函數(shù)時(shí)，在完成傳輸或發(fā)生錯(cuò)誤之前該函數(shù)不會(huì)返回。main的最后一步是提交返回狀態(tài)，提交頁面讀取，最后使用 curl_easy_cleanup清除（當(dāng)使用句柄執(zhí)行完操作后）。
現(xiàn)在看看 write_data函數(shù)。該函數(shù)是針對特定操作收到數(shù)據(jù)時(shí)調(diào)用的回調(diào)。注意，當(dāng)您從網(wǎng)站讀取數(shù)據(jù)時(shí)，將寫入該數(shù)據(jù)（write_data）。將向回調(diào)提供一個(gè)緩沖區(qū)（包含可用數(shù)據(jù)）、成員數(shù)量和大?。ň彌_中可用數(shù)據(jù)總量）、上下文指針。第一個(gè)任務(wù)是確保緩沖區(qū)（wr_buf）的空間足以寫入數(shù)據(jù)。如果不夠，它將設(shè)置上下文指針并返回 0，表示出現(xiàn)問題。否則，它將 cURL 緩沖區(qū)的數(shù)據(jù)復(fù)制到您的緩沖區(qū)，并增加索引，指向要寫入的下一個(gè)位置。本例還終止字符串，稍后可以對其使用 printf。最后，它返回 libcurl 操作的字節(jié)數(shù)量。這將告訴 libcurl 數(shù)據(jù)被提取，它也可以丟棄該數(shù)據(jù)。這就是從網(wǎng)站將文件讀取到內(nèi)存的相對簡單的方法。
|
