Libcurl簡明使用指南

工程師WWW發表於2014-04-08

Libcurl為一個免費開源的,客戶端url傳輸庫,支援FTP,FTPS,TFTP,HTTP,HTTPS,GOPHER,TELNET,DICT,FILE和LDAP,跨平臺,支援Windows,Unix,Linux等,執行緒安全,支援Ipv6。並且易於使用。

http://curl.haxx.se/libcurl/

 

從http://curl.haxx.se/libcurl/ 下載一個穩定的版本,注意選擇OS。

 

編譯libcurl

下載下來的是原始碼包,需要編譯。

解壓zip檔案,進入curl-7.14.0\lib目錄(我下載的是7.14.0)。

編譯Debug版本。新建一個批處理bat檔案,如buildDebug.bat,內容如下:

call "C:\Program Files\Microsoft Visual Studio\VC98\Bin\vcvars32.bat"

set CFG=debug-dll-ssl-dll-zlib-dll

set OPENSSL_PATH=E:\SSL\openssl-0.9.7e

set ZLIB_PATH=E:\zip\zlib123

nmake -f Makefile.vc6

 

其輸出:libcurld_imp.lib, libcurld.dll

 

編譯Release版本。新建一個批處理檔案BuildRelease.bat,內容如下:

call "C:\Program Files\Microsoft Visual Studio\VC98\Bin\vcvars32.bat"

set CFG=release-dll-ssl-dll-zlib-dll

set OPENSSL_PATH=E:\SSL\openssl-0.9.7e

set ZLIB_PATH=E:\zip\zlib123

nmake -f Makefile.vc6

 

其輸出:libcurl_imp.lib, libcurl.dll

 

上面編譯的是libcurl的 dll,使用OpenSSL Dll版本和Zlib Dll版本。如果沒有,可以從www.openssl.org 或者http://www.zlib.net/ 下載。

如果需要編譯其他版本,可檢視Makefile.vc6,設定相應的CFG 引數即可。

 

商業軟體使用libcurl時,只需要包含其copywrite宣告即可。

 

Sample

 

clip_image001#include <stdio.h>
clip_image001#include "../curl-7.14.0/include/curl/curl.h"
clip_image001#pragma comment(lib, "../curl-7.14.0/lib/libcurl_imp.lib")
clip_image001
clip_image001int main(void)
clip_image002clip_image003{
clip_image005  curl = curl_easy_init();
clip_image006clip_image007  
if(curl) {
clip_image005
clip_image005    CURLcode res;    
clip_image005    res = curl_easy_setopt(curl, CURLOPT_PROXY, "Test-pxy08:8080");
clip_image005    res = curl_easy_setopt(curl, CURLOPT_PROXYTYPE, CURLPROXY_HTTP);
clip_image005    res = curl_easy_setopt(curl, CURLOPT_URL, "http://www.vckbase.com");
clip_image005    res = curl_easy_perform(curl);
clip_image005
clip_image006clip_image007    
if(CURLE_OK == res) {
clip_image005      
char *ct;
clip_image006clip_image007      /* ask for the content-type */
clip_image006clip_image007      /* http://curl.haxx.se/libcurl/c/curl_easy_getinfo.html */
clip_image005      res = curl_easy_getinfo(curl, CURLINFO_CONTENT_TYPE, &ct);
clip_image005
clip_image005      if((CURLE_OK == res) && ct)
clip_image005        printf("We received Content-Type: %s ", ct);
clip_image008    }
clip_image005
clip_image006clip_image007    /* always cleanup */
clip_image005    curl_easy_cleanup(curl);
clip_image008  }
clip_image005  return 0;
clip_image009}



另:

libcurl使用心得

Libcurl為一個免費開源的,客戶端url傳輸庫,支援FTP,FTPS,TFTP,HTTP,HTTPS,GOPHER,TELNET,DICT,FILE和LDAP,跨平臺,支援Windows,Unix,Linux等,執行緒安全,支援Ipv6。並且易於使用。

http://curl.haxx.se/libcurl/

從http://curl.haxx.se/libcurl/ 下載一個穩定的版本,注意選擇OS。
在使用之前請大家多閱讀libcurl的文件:因為如果要實際運用到專案中,最好對libcurl有具體的瞭解,具體在
http://curl.haxx.se/libcurl/c/
curl_easy_setopt() 
curl_easy_perform() 
curl_easy_getinfo() 
這三個函式的使用上,需要多去鑽研,多看Samples,你才能靈活使用libcurl。
感謝這篇文章:
http://blog.163.com/xu_chao2000/blog/static/27770610200801303252802/
給了我許多啟發,再次感謝!

給出我的一個簡單的程式碼例子:
說明:
1.關鍵在curl_easy_setopt函式設定option,可以設定ftp,http,get,post等許多選項,請根據具體使用情況設定。

2.對取回來的資料需要進行判斷,比如http下載檔案,如果檔案不存在,需要進行處理。因為writer是可以將buf填充404 not found等網頁內容的,不能將這個內容當成檔案內容,所以需要判斷http web返回來的code,進行判斷。

3.我有個問題,就是想得到伺服器上filename的具體名稱,verbose除錯已經返回了,但是我在getinfo的時候,試過好多選項,但未找到這個存放真實伺服器檔名的選項,如果有知道的麻煩告訴我,謝謝了!

#include "curl/curl.h"
#pragma comment(lib, "libcurl.lib")

long writer(void *data, int size, int nmemb, string &content);
bool  CurlInit(CURL *&curl, const char* url,string &content);
bool  GetURLDataBycurl(const char* URL, string &content);

void main()
{
    char *url ="http://www.baidu.com/img/baidu.gif";
    string content;
    if ( GetURLDataBycurl(url,content))
    {
        printf("%s\n",content);

    }

    getchar();
}


bool CurlInit(CURL *&curl, const char* url,string &content)
{
    CURLcode code;
    string error;
    curl = curl_easy_init();
    if (curl == NULL)
    {
        printf( "Failed to create CURL connection\n");
        return false;
    }

    code = curl_easy_setopt(curl, CURLOPT_ERRORBUFFER, error);
    if (code != CURLE_OK)
    {
        printf( "Failed to set error buffer [%d]\n", code );
        return false;
    }

    curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
    code = curl_easy_setopt(curl, CURLOPT_URL, url);
    if (code != CURLE_OK)
    {
        printf("Failed to set URL [%s]\n", error);
        return false;
    }

    code = curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1);
    if (code != CURLE_OK)
    {
        printf( "Failed to set redirect option [%s]\n", error );
        return false;
    }

    code = curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writer);
    if (code != CURLE_OK)
    {
        printf( "Failed to set writer [%s]\n", error);
        return false;
    }

    code = curl_easy_setopt(curl, CURLOPT_WRITEDATA, &content);
    if (code != CURLE_OK)
    {
        printf( "Failed to set write data [%s]\n", error );
        return false;
    }

    return true;
}


long writer(void *data, int size, int nmemb, string &content)
{
    long sizes = size * nmemb;
    string temp(data,sizes);
    content += temp; 
    return sizes;
}


bool GetURLDataBycurl(const char* URL,  string &content)
{
    CURL *curl = NULL;
    CURLcode code;
    string error;

    code = curl_global_init(CURL_GLOBAL_DEFAULT);
    if (code != CURLE_OK)
    {
        printf( "Failed to global init default [%d]\n", code );
        return false;
    }
 
    
    if ( !CurlInit(curl,URL,content) )
    {
        printf( "Failed to global init default [%d]\n" );
        return PM_FALSE;
    }

    code = curl_easy_perform(curl);
    if (code != CURLE_OK)
    {
        printf( "Failed to get '%s' [%s]\n", URL, error);
        return false;
    }

    long retcode = 0;
    code = curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE , &retcode); 
    if ( (code == CURLE_OK) && retcode == 200 )
    {
        double length = 0;
        code = curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD , &length); 
        printf("%d",retcode);
        FILE * file = fopen("1.gif","wb");
        fseek(file,0,SEEK_SET);
        fwrite(content.c_str(),1,length,file);
        fclose(file);

        //struct curl_slist *list;
        
//code = curl_easy_getinfo(curl,CURLINFO_COOKIELIST,&list);
        
//curl_slist_free_all (list);

        return true;
    }

    else
    {
    //    debug1( "%s \n ",getStatusCode(retcode));
        return false;
    }

    curl_easy_cleanup(curl);
    return false;
}

1.登陸https網站,在不使用證書的情況下,要設定:
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0);
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0);