關(guān)于libcurl庫(kù)

libcurl是一個(gè)跨平臺(tái)的網(wǎng)絡(luò)協(xié)議庫(kù)舅世，支持http, https, ftp, gopher, telnet, dict, file, 和ldap 協(xié)議撰筷。libcurl同樣支持HTTPS證書(shū)授權(quán)睹欲，HTTP POST, HTTP PUT, FTP 上傳, HTTP基本表單上傳，代理，cookies,和用戶(hù)認(rèn)證。想要知道更多關(guān)于libcurl的介紹秒际，可以到官網(wǎng) http://curl.haxx.se/上去了解，在這里不再詳述狡汉。本文主要介紹如何在Visual Studio 2013開(kāi)發(fā)環(huán)境中編譯并使用libcurl庫(kù)娄徊。

1、下載libcurl源代碼

libcurl最新源代碼下載地址為：https://curl.haxx.se/download/curl-7.67.0.zip盾戴，對(duì)應(yīng)的下載頁(yè)面為：https://curl.haxx.se/download.html寄锐。下載后解壓到某個(gè)目錄下，對(duì)應(yīng)的文件目錄結(jié)構(gòu)如下圖所示：

libcurl庫(kù)的源代碼目錄結(jié)構(gòu)

2、使用Visual Studio 2013編譯libcurl源代碼

在自己的Windows系統(tǒng)上安裝好Visual Sutido 2013之后橄仆，并且下載好libcurl的最新源代碼后剩膘，就可以開(kāi)始在Visual Studio 2013中編譯libcurl的源代碼了，筆者寫(xiě)這篇文章時(shí)libcurl的最新版本是7.67.0盆顾，使用的是Windows10系統(tǒng)怠褐。
libcurl源代碼目錄下winbuild文件夾下的BUILD.WINDOWS.txt詳細(xì)描述了如何使用Visual C++編譯工具編譯、構(gòu)建和安裝curl以及l(fā)ibcurl的源代碼您宪，我使用的是Visual Studio 2013奈懒。
首先在Window10系統(tǒng)最左側(cè)的Windows菜單找到Visual Studio 2013下的【Visual Studio Tools】并打開(kāi)，如下圖所示：

Visual Studio Tools

我在自己的Windows10系統(tǒng)下同時(shí)安裝了Visual Studio 2017和Visual Studio 2013宪巨。
打開(kāi)Visual Studio Tools磷杏，可以看到對(duì)應(yīng)的快捷鍵，如下圖所示：

Visual Studio Tools命令快捷鍵

C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC>E:

E:\>cd E:\SoftDevelop\CPlus\VCProject2013\curl-7.67.0

E:\SoftDevelop\CPlus\VCProject2013\curl-7.67.0>cd winbuild

E:\SoftDevelop\CPlus\VCProject2013\curl-7.67.0\winbuild>

命令行

關(guān)于使用VS2013 x86本機(jī)工具命令提示編譯libcurl源代碼汰规，采用的是VC的nmake命令汤功，相當(dāng)于Windows下的make工具物邑。
官網(wǎng)文件如下：

Building with Visual C++
========================

Open a Visual Studio Command prompt:

     Using the 'Developer Command Prompt for VS <version>' menu entry:
       where version is the Visual Studio version. The developer prompt at default
       uses the x86 mode. It is required to call Vcvarsall.bat to setup the prompt
       for the machine type you want, using Vcvarsall.bat.
       This type of command prompt may not exist in all Visual Studio versions.

       For more information, check:
         https://docs.microsoft.com/en-us/dotnet/framework/tools/developer-command-prompt-for-vs
         https://docs.microsoft.com/en-us/cpp/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line

     Using the 'VS <version> <platform> <type> Command Prompt' menu entry:
       where version is the Visual Studio version, platform is e.g. x64
       and type Native of Cross platform build.  This type of command prompt
       may not exist in all Visual Studio versions.

       See also:
         https://msdn.microsoft.com/en-us/library/f2ccy3wt.aspx

Once you are in the console, go to the winbuild directory in the Curl
sources:
    cd curl-src\winbuild

Then you can call nmake /f Makefile.vc with the desired options (see below).
The builds will be in the top src directory, builds\ directory, in
a directory named using the options given to the nmake call.

nmake /f Makefile.vc mode=<static or dll> <options>

where <options> is one or many of:
  VC=<6,7,8,9,10,11,12,14,15>    - VC versions
  WITH_DEVEL=<path>              - Paths for the development files (SSL, zlib, etc.)
                                   Defaults to sibbling directory deps: ../deps
                                   Libraries can be fetched at https://windows.php.net/downloads/php-sdk/deps/
                                   Uncompress them into the deps folder.
  WITH_SSL=<dll or static>       - Enable OpenSSL support, DLL or static
  WITH_NGHTTP2=<dll or static>   - Enable HTTP/2 support, DLL or static
  WITH_MBEDTLS=<dll or static>   - Enable mbedTLS support, DLL or static
  WITH_CARES=<dll or static>     - Enable c-ares support, DLL or static
  WITH_ZLIB=<dll or static>      - Enable zlib support, DLL or static
  WITH_SSH2=<dll or static>      - Enable libSSH2 support, DLL or static
  WITH_PREFIX=<dir>              - Where to install the build
  ENABLE_SSPI=<yes or no>        - Enable SSPI support, defaults to yes
  ENABLE_IPV6=<yes or no>        - Enable IPv6, defaults to yes
  ENABLE_IDN=<yes or no>         - Enable use of Windows IDN APIs, defaults to yes
                                   Requires Windows Vista or later
  ENABLE_WINSSL=<yes or no>      - Enable native Windows SSL support, defaults to yes
  GEN_PDB=<yes or no>            - Generate Program Database (debug symbols for release build)
  DEBUG=<yes or no>              - Debug builds
  MACHINE=<x86 or x64>           - Target architecture (default is x86)
  CARES_PATH=<path to cares>     - Custom path for c-ares
  MBEDTLS_PATH=<path to mbedTLS> - Custom path for mbedTLS
  NGHTTP2_PATH=<path to HTTP/2>  - Custom path for nghttp2
  SSH2_PATH=<path to libSSH2>    - Custom path for libSSH2
  SSL_PATH=<path to OpenSSL>     - Custom path for OpenSSL
  ZLIB_PATH=<path to zlib>       - Custom path for zlib

上面的文檔中，可以使用DEBUG=yes編譯Debug版本的庫(kù)滔金，默認(rèn)是Release版本的色解；
MACHINE=x64可以編譯生成x64的庫(kù)，默認(rèn)是x86的餐茵。

• 1科阎、 使用VS2013編譯libcurl的debug版的static靜態(tài)庫(kù) libcurl-vc-x86-debug-static-ipv6-sspi-winssl
  對(duì)應(yīng)的命令為：nmake /f Makefile.vc mode=static DEBUG=yes

E:\SoftDevelop\CPlus\VCProject2013\curl-7.67.0\winbuild>nmake /f Makefile.vc mode=static DEBUG=yes

• 2、使用VS2013編譯libcurl的debug本的dll動(dòng)態(tài)庫(kù) libcurl-vc-x86-debug-dll-ipv6-sspi-winssl
• 對(duì)應(yīng)的命令為：nmake /f Makefile.vc mode=dll DEBUG=yes

E:\SoftDevelop\CPlus\VCProject2013\curl-7.67.0\winbuild>nmake /f Makefile.vc mode=dll DEBUG=yes

• 3忿族、使用VS2013編譯libcurl的release版的x86的static靜態(tài)庫(kù) libcurl-vc-x86-release-static-ipv6-sspi-winssl
  命令為：nmake /f Makefile.vc mode=static

E:\SoftDevelop\CPlus\VCProject2013\curl-7.67.0\winbuild>nmake /f Makefile.vc mode=static

Microsoft (R) 程序維護(hù)實(shí)用工具 12.00.21005.1 版
版權(quán)所有 (C) Microsoft Corporation锣笨。  保留所有權(quán)利。

configuration name: libcurl-vc-x86-release-static-ipv6-sspi-winssl
        cl /O2 /DNDEBUG /MD /DCURL_STATICLIB /I. /I ../lib /I../include /nologo /W4 /wd4127 /EHsc /DWIN32 /FD /c /DBUILDING_LIBCURL  /DUSE_WIN32_IDN /DWANT_IDN_PROTOTYPES  /DUSE_IPV6  /DUSE_WINDOWS_SSPI /DUSE_SCHANNEL /Fo"..\builds\libcurl-vc-x86-release-static-ipv6-sspi-winssl-obj-lib/file.obj"  ..\lib\file.c
file.c

• 4道批、使用VS2013編譯libcurl的release的dll動(dòng)態(tài)庫(kù) libcurl-vc-x86-release-dll-ipv6-sspi-winssl
  對(duì)應(yīng)的命令為：nmake /f Makefile.vc mode=dll

 E:\SoftDevelop\CPlus\VCProject2013\curl-7.67.0\winbuild>nmake /f Makefile.vc mode=dll

默認(rèn)會(huì)在源代碼的頂層目錄下創(chuàng)建builds文件夾错英，用于存放編譯生成的文件。
如下圖所示：

builds文件夾

上面的目錄隆豹，以編譯debug版本的dll庫(kù)為例椭岩，最后為在curl源代碼所在目錄的builds下生成libcurl-vc-x86-debug-dll-ipv6-sspi-winssl文件夾，它是編譯最終頭文件、庫(kù)文件判哥、可執(zhí)行程序所在目錄献雅，include是curl庫(kù)的頭文件存放目錄；lib庫(kù)是庫(kù)文件所在目錄塌计，里面有l(wèi)ibcurl_debug.lib文件挺身；bin目錄是生成的curl.exe可執(zhí)行文件和libcurl_debug.dll的dll文件所在目錄，如下圖所示：

libcurl-vc-x86-debug-dll-ipv6-sspi-winssl

卷 Data 的文件夾 PATH 列表
卷序列號(hào)為 3EE8-BA3A
D:.
│  tree.txt
│  
├─bin
│      curl.exe
│      libcurl.dll
│      libcurl_debug.dll
│      
├─include
│  └─curl
│          curl.h
│          curlver.h
│          easy.h
│          mprintf.h
│          multi.h
│          stdcheaders.h
│          system.h
│          typecheck-gcc.h
│          urlapi.h
│          
└─lib
    └─x86
        ├─debug
        │      libcurl_debug.lib
        │      
        └─release
                libcurl.lib

libcurl_vs2013_x86

為了方便，我一般把一些第三方庫(kù)放在系統(tǒng)的某個(gè)固定目錄丽旅，如D:\env_build目錄椰棘，我把編譯后的libcurl的debug和release版的x86動(dòng)態(tài)庫(kù)以及頭文件存放在libcurl_vs2013_x86目錄下。

3榄笙、在Visual Studio 2013中使用libcurl庫(kù)

(1)邪狞、創(chuàng)建一個(gè)Win32 VC++控制臺(tái)的空項(xiàng)目

打開(kāi)Visual Studio 2013開(kāi)發(fā)工具，創(chuàng)建一個(gè)基于Win32 VC++的控制臺(tái)的空項(xiàng)目茅撞，取名為libcurlDemo1,并選好程序存放的路徑帆卓，我的存放路徑為，如下圖所示：

使用VS2013新建一個(gè)Win32控制臺(tái)的項(xiàng)目

12

13

至此在Visual Studio 2013中生成了一個(gè)VC++控制臺(tái)的空項(xiàng)目米丘，如下圖所示：

14

（2）添加項(xiàng)目代碼以及l(fā)ibcurl的頭文件和依賴(lài)庫(kù)

在Visual Stuido 2013中新增一個(gè)main.cpp源代碼文件剑令，
main.cpp只是一個(gè)使用libcurl庫(kù)的示例程序，更多的示例可以參考libcurl官網(wǎng)：https://curl.haxx.se/libcurl/c/example.html或者Githubhttps://github.com/curl/curl/tree/master/docs/examples
// main.cpp

#include <stdio.h>
#include <curl/curl.h>
#include <stdlib.h>

int main(int argc, char *argv[])
{
    CURL *curl;             //定義CURL類(lèi)型的指針
    CURLcode res;           //定義CURLcode類(lèi)型的變量拄查，保存返回狀態(tài)碼
    
    char url[] = "www.baidu.com";
    curl = curl_easy_init();        //初始化一個(gè)CURL類(lèi)型的指針
    if (curl != NULL)
    {
        //設(shè)置curl選項(xiàng). 其中CURLOPT_URL是讓用戶(hù)指 定url. url中存放的是網(wǎng)址
        curl_easy_setopt(curl, CURLOPT_URL, url);
        //調(diào)用curl_easy_perform 執(zhí)行我們的設(shè)置.并進(jìn)行相關(guān)的操作. 在這 里只在屏幕上顯示出來(lái).
        res = curl_easy_perform(curl);
        //清除curl操作.
        curl_easy_cleanup(curl);
    }

    return 0;
}

15

從上圖可以看到在沒(méi)有導(dǎo)入libcurl庫(kù)的頭文件時(shí)VS2013會(huì)提示紅色的錯(cuò)誤吁津。
下面在VS2013中加入我們剛才編譯好的libcurl庫(kù)
在VS2013左下角的【屬性管理器】->【Debug|Win32】,右鍵單擊【Debug|Win32】，選擇【屬性】堕扶，進(jìn)入到【Debug屬性頁(yè)對(duì)話(huà)框】碍脏，如下圖所示：

16

17

• 添加libcurl的頭文件所在目錄
  選擇【C/C++】->【常規(guī)】->【附加包含目錄】，在【附加包含目錄】中添加libcurl所在的頭文件路徑稍算，我的是：D:\env_build\libcurl_vs2013_x86\include
  如下圖所示：

  
  
  18
• 添加libcurl的debug動(dòng)態(tài)庫(kù)目錄
  依次選擇【Debug屬性頁(yè)】->【鏈接器】->【常規(guī)】典尾，在附加庫(kù)目錄中添加剛才編譯好的lib庫(kù)所在目錄，如D:\env_build\libcurl_vs2013_x86\lib\x86\debug目錄邪蛔，如下圖所示：

19

20

選擇【Debug屬性頁(yè)】->【鏈接器】->【輸入】->【附加依賴(lài)項(xiàng)】中急黎，加入D:\env_build\libcurl_vs2013_x86\lib\x86\debug目錄下的libcurl_debug.lib文件名扎狱，如下圖所示：

21

頭文件加入后故源，相關(guān)的紅色錯(cuò)誤消失了觉渴，如下圖所示：

22

3沐鼠、運(yùn)行l(wèi)ibcurlDemo1程序

添加好libcurl庫(kù)的頭文件和動(dòng)態(tài)庫(kù)后崔兴，運(yùn)行程序匀奏，發(fā)現(xiàn)出現(xiàn)如下的錯(cuò)誤：

23

24

26

26

4奶是、使用屬性表文件

有時(shí)候?yàn)榱吮苊鉃槊總€(gè)項(xiàng)目都添加頭文件和lib依賴(lài)庫(kù)文件楣责，可以使用為某個(gè)第三方依賴(lài)庫(kù)比如libcurl創(chuàng)建對(duì)應(yīng)的屬性表文件，以props為后綴聂沙，
在剛才的VS2013的libcurlDemo1項(xiàng)目中秆麸，針對(duì)debug的x86項(xiàng)目，創(chuàng)建一個(gè)libcurl_debug_x86_vs2013.props的屬性表文件及汉，選擇【屬性頁(yè)管理器】->【Debug|Win32】沮趣，右鍵單擊，【添加新項(xiàng)目屬性表】坷随，在【添加新項(xiàng)】對(duì)話(huà)框中輸入屬性表名稱(chēng)房铭，如下圖所示：

27

右鍵單擊libcurl_debug_x86_vs2013.props的屬性表文件,選擇【屬性】菜單，在libcurl_debug_x86_vs2013.props屬性頁(yè)的對(duì)話(huà)框中添加libcurl的頭文件和lib庫(kù)文件甸箱，同上育叁。

5、相關(guān)資料

(1)build-libcurl-windows

github上面有一個(gè)項(xiàng)目build-libcurl-windows芍殖，Batch script to download and build libcurl (using Visual Studio compiler)，即使用build.bat腳本下載libcurl源代碼并編譯谴蔑，前提是在Windows系統(tǒng)下安裝了Visual Studio開(kāi)發(fā)環(huán)境豌骏，本人親測(cè)好使。

28

(2)隐锭、build-libcurl-ios

github上面有一個(gè)項(xiàng)目build-libcurl-ios窃躲，是針對(duì)ios環(huán)境下的libcurl的編譯。

(3)钦睡、C++ 用libcurl庫(kù)進(jìn)行http通訊網(wǎng)絡(luò)編程