c++开发之编译curl(windows版本)

在 Windows 上编译支持 OpenSSL 的 cURL 库并不简单，因为涉及到多个库的依赖关系以及工具链的配置。以下是编译支持 OpenSSL 的 cURL 库的详尽步骤：

环境要求

1. 编译工具链：

   • MinGW 或 Visual Studio
   • CMake
   • Perl (用于编译 OpenSSL)
   • NASM (用于编译 OpenSSL)

2. 库：

   • OpenSSL
   • cURL

步骤概览

1. 安装编译工具链
2. 编译 OpenSSL
3. 编译 cURL 并链接 OpenSSL
4. 测试

详细步骤

1. 安装编译工具链

如果你使用 MinGW，请安装 MinGW-w64，并确保路径中包含 gcc、g++、ld 等工具。

如果你使用 Visual Studio，安装 Visual Studio 并确保安装了 C++ 开发工具包（MSVC 编译器）。

安装 CMake 以帮助生成适合不同编译器的构建文件。

# 确认 cmake 和编译器可以正常运行
cmake --version
gcc --version (或 cl --version)

2. 编译 OpenSSL

1. 下载 OpenSSL 源代码： 从 OpenSSL 官方 下载 OpenSSL 源代码。

2. 解压并进入 OpenSSL 源代码目录： 打开命令提示符，进入下载并解压后的目录。

   tar -xvf openssl-1.1.1x.tar.gz
   cd openssl-1.1.1x
   

3. 配置 OpenSSL：

   • MinGW： 使用 MinGW 编译时，配置 OpenSSL：

     perl Configure mingw64 --prefix=C:/path/to/install/openssl

   • Visual Studio： 如果使用 MSVC，配置 OpenSSL：

     perl Configure VC-WIN64A --prefix=C:/path/to/install/openssl

4. 编译并安装： 使用 nmake 或 make 进行编译：

   • MinGW：

     mingw32-make mingw32-make install

   • Visual Studio：

     nmake nmake install

   编译完成后，OpenSSL 的二进制文件会安装在你指定的 --prefix 路径中。

3. 编译 cURL 并链接 OpenSSL

1. 下载 cURL 源代码： 从 cURL 官方 下载最新的 cURL 源代码，并解压。

   tar -xvf curl-7.xx.x.tar.gz cd curl-7.xx.x

2. 配置 cURL：

   使用 CMake 配置 cURL 项目，并指定 OpenSSL 的路径。

   • MinGW： 如果使用 MinGW，运行以下命令：

     cmake -G "MinGW Makefiles" -DCMAKE_USE_OPENSSL=ON -DOPENSSL_ROOT_DIR=C:/path/to/install/openssl -DOPENSSL_INCLUDE_DIR=C:/path/to/install/openssl/include -DCMAKE_INSTALL_PREFIX=C:/path/to/install/curl

   • Visual Studio： 如果使用 Visual Studio，运行以下命令：

     cmake -G "Visual Studio 16 2019" -A x64 -DCMAKE_USE_OPENSSL=ON -DOPENSSL_ROOT_DIR=C:/path/to/install/openssl -DOPENSSL_INCLUDE_DIR=C:/path/to/install/openssl/include -DCMAKE_INSTALL_PREFIX=C:/path/to/install/curl

   CMake 参数说明：

   • -DCMAKE_USE_OPENSSL=ON：启用 OpenSSL 支持。
   • -DOPENSSL_ROOT_DIR：指定 OpenSSL 的安装路径。
   • -DOPENSSL_INCLUDE_DIR：指定 OpenSSL 的头文件路径。
   • -DCMAKE_INSTALL_PREFIX：指定 cURL 的安装路径。

3. 编译并安装 cURL：

   • MinGW：

     mingw32-make mingw32-make install

   • Visual Studio： 打开 Visual Studio 的开发者命令提示符并运行：

     nmake nmake install

   安装完成后，cURL 可执行文件和库会被安装在你指定的路径中。

4. 测试

1. 检查是否成功编译： 进入安装路径，运行 curl 查看是否能正常运行。

   curl --version

   应该输出包含 OpenSSL 支持的信息：

   curl 7.xx.x (x86_64-pc-win32) libcurl/7.xx.x OpenSSL/1.1.1x

2. 测试 HTTPS 请求： 运行一个 HTTPS 请求来验证 OpenSSL 支持。

   curl https://www.example.com

额外注意事项

• 依赖的库：在 Windows 上，确保所有依赖库都已正确安装并可以被链接。
• 路径问题：确保所有依赖库的路径（如 OpenSSL）被正确设置在系统环境变量中。
• OpenSSL 版本：确保 OpenSSL 版本与 cURL 兼容，推荐使用最新稳定版本。

这样就完成了在 Windows 上使用 OpenSSL 编译 cURL 的过程。

附使用案例：

在 Visual Studio 2010 中添加和使用 cURL 库的步骤如下，详细说明如何下载、配置和在项目中使用 cURL 库。

1. 下载所需的文件（也可以使用自己编译的版本）

• cURL 库：从 cURL 官网 下载预编译的 Windows 版本。选择合适的版本（如带有 SSL 支持的版本）。
• OpenSSL 库：如果需要 HTTPS 支持，下载与 cURL 兼容的 OpenSSL 库。
• zlib 库（可选）：如果需要支持压缩或解压缩功能，可下载 zlib 库。

2. 配置 cURL 库

1. 解压库文件： 将下载的 cURL 和 OpenSSL（如果需要）解压到你选择的路径，如：

   C:\libs\curl C:\libs\openssl

2. 包含头文件和库文件： 在解压后的文件夹中找到以下内容：

   • 头文件（include 文件夹中的 .h 文件）
   • 库文件（lib 文件夹中的 .lib 文件，可能还有 .dll 文件）

3. 在 Visual Studio 2010 项目中添加 cURL 库

1. 创建新项目： 打开 Visual Studio 2010，创建一个新的 C++ 控制台项目，或在现有项目中使用。

2. 配置项目属性：

   • 右键点击项目 -> Properties (属性)。
   • 在属性页中，找到 Configuration Properties -> C/C++ -> General。
     • 在 Additional Include Directories 中添加 cURL 和 OpenSSL 的头文件路径：

       C:\libs\curl\include C:\libs\openssl\include

3. 配置链接库：

   • 继续在 Configuration Properties 中，找到 Linker -> General。
     • 在 Additional Library Directories 中添加 cURL 和 OpenSSL 的库文件路径：

       C:\libs\curl\lib C:\libs\openssl\lib

4. 添加库文件：

   • 在 Linker -> Input 下，找到 Additional Dependencies，并添加以下库：
     • 对于 cURL：

       libcurl.lib

     • 对于 OpenSSL（如果使用 HTTPS）：

       libssl.lib libcrypto.lib

4. 项目中使用 cURL 库

在项目的源代码文件中包含 cURL 的头文件，并编写示例代码。例如，在 main.cpp 中添加以下代码：

#include <iostream>
#include <curl/curl.h>// 写入数据的回调函数，用于处理 cURL 请求的响应数据
size_t WriteCallback(void* contents, size_t size, size_t nmemb, void* userp)
{((std::string*)userp)->append((char*)contents, size * nmemb);return size * nmemb;
}int main()
{CURL* curl;CURLcode res;// 初始化 cURLcurl = curl_easy_init();if(curl) {std::string readBuffer;// 设置请求的 URLcurl_easy_setopt(curl, CURLOPT_URL, "https://www.example.com");// 设置回调函数来处理服务器响应数据curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer);// 执行请求res = curl_easy_perform(curl);// 检查是否有错误if(res != CURLE_OK)fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));elsestd::cout << "Response Data: " << readBuffer << std::endl;// 清理 cURLcurl_easy_cleanup(curl);}return 0;
}

5. 配置依赖的动态库（.dll）

如果使用了 .dll 库（特别是 OpenSSL），确保将 .dll 文件复制到项目的可执行文件路径，或者将其路径添加到系统环境变量 PATH 中。常见的 .dll 包括：

• libcurl.dll
• libssl.dll
• libcrypto.dll

这些文件可以从 OpenSSL 和 cURL 解压文件夹中的 bin 目录找到。

6. 生成并运行项目

在项目属性中选择 Debug 或 Release 版本，确保所有库的路径和文件正确配置。点击 Build -> Build Solution来编译项目。

如果一切配置正确，你将会看到来自 https://www.example.com 的响应数据输出到控制台。

7. 常见问题和解决方案

1. 找不到库文件：确保库文件路径正确配置，并且 .lib 文件存在于指定的路径中。
2. DLL 找不到错误：运行时确保将相应的 .dll 文件放置在可执行文件所在目录，或者将其路径添加到系统环境变量 PATH 中。
3. SSL 错误：如果需要支持 HTTPS，请确保 OpenSSL 的库文件被正确配置，并且 .dll 文件位于系统路径中。