Curl.h详解

发布时间：2023-05-20

在编写Web程序时，常常使用到Curl库提供的功能。Curl是一个用于传输数据的免费开源库，支持众多协议。Curl库提供了多种各异的功能，包括协议支持，HTTP，HTTPS，FTP，SMTP等，以及文件上传和下载，Cookie获取和保存，代理设置，等等。Curl.h是其中的一个头文件，提供了很多实用的API。

一、curl.h cmake运行报错

在使用CMake生成Makefile的过程中，可能会出现类似于以下的错误:

fatal error: curl/curl.h: No such file or directory

这种错误通常是由于curl.h头文件未找到引起的。 解决该问题需要修改CMakeLists.txt文件，添加如下代码：

find_package(CURL REQUIRED)
include_directories(${CURL_INCLUDE_DIR})
target_link_libraries(Project ${CURL_LIBRARY})

二、curl换行

curl换行 symbols在curl.h文件中包含，用于在windows系统中处理文本文件中的换行符时，转换成Unix/Linux格式（即使用换行符“/n”作为换行标志，而非windows下换行“/r/n”）。 示例代码：

ch = curl_easy_init();   
curl_easy_setopt(ch, CURLOPT_LINEEND, CURL_LINEEND_UNIX);

三、curlhair

在curl.h中，Curlhair是一个比较重要的概念。它实际上是一个数据结构体类型，用于存储与Curl会话相关的信息，包括URL、HTTP状态、请求头、响应头、发送/接收的数据等。 以下是一个用于初始化和清空CurlHair的示例代码：

CURL *ch;
CURLcode result;
// 初始化 curl 会话
ch = curl_easy_init();
if(ch) {
  curl_easy_setopt(ch, CURLOPT_URL, "http://example.com");
  result = curl_easy_perform(ch);
  if(result != CURLE_OK) {
    // 网络连接出错等处理代码...
  }
  curl_easy_cleanup(perf->ch);
  perf->ch = 0;
}

四、curl和rot

在curl.h中，Rot是一种特殊的处理方式。它用于在传输过程中处理已经被压缩的数据。如果不使用Rot，可能会导致数据丢失或传输错误。 以下是一个典型的CURL Rot示例代码：

CURL *ch;
CURLcode result;
ch = curl_easy_init();
if(ch) {
  curl_easy_setopt(ch, CURLOPT_URL, "http://example.com");
  curl_easy_setopt(ch, CURLOPT_WRITEFUNCTION, write_data);
  curl_easy_setopt(ch, CURLOPT_WRITEDATA, &data);
  curl_easy_setopt(ch, CURLOPT_ACCEPT_ENCODING, "gzip, deflate");
  result = curl_easy_perform(ch);
}

五、curl环境变量配置

在使用curl.h时，有时候会需要配置一些环境变量，以便满足特定的场景需求。 其实，在Curl库中，自带有一些环境变量，可以在初始化和设置函数时使用。这些环境变量包括路径、代理、超时时间、重定向、Cookie、证书、HTTP验证、HTTP头等。 以下是一个使用curl.h中环境变量的示例代码：

CURL *ch;
CURLcode result;
char* caFile = "/path/to/ca/file.pem"; // 指定CA证书路径
ch = curl_easy_init();
if(ch) {
  curl_easy_setopt(ch, CURLOPT_URL, "https://example.com");
  curl_easy_setopt(ch, CURLOPT_SSLCERT, caFile );
  curl_easy_setopt(ch, CURLOPT_SSL_VERIFYHOST, 2L);
  curl_easy_setopt(ch, CURLOPT_SSL_VERIFYPEER, 1L);
  result = curl_easy_perform(ch);
}

六、curl忽略证书

如果服务器证书无效，可以在使用curl.h时忽略它。这里使用两种方法实现。 第一种方法：在设置中将SSL验证设置为false，示例代码如下：

CURL *ch = curl_easy_init();
CURLEcode res;
if (ch) {
  curl_easy_setopt(ch, CURLOPT_URL, "https://example.com");
  curl_easy_setopt(ch, CURLOPT_SSL_VERIFYPEER, false);
  curl_easy_setopt(ch, CURLOPT_FOLLOWLOCATION, 1L);
  res = curl_easy_perform(ch);
}

第二种方法：在curl_easy_setopt()函数中使用 CURLOPT_SSL_OPTIONS设置。 示例代码如下：

CURL *ch = curl_easy_init();
CURLEcode res;
if (ch) {
  curl_easy_setopt(ch, CURLOPT_URL, "https://example.com");
  curl_easy_setopt(ch, CURLOPT_SSL_VERIFYPEER, true);
  curl_easy_setopt(ch, CURLOPT_SSL_OPTIONS, CURLSSLOPT_ALLOW_BEAST | CURLSSLOPT_NO_REVOKE);
  curl_easy_setopt(ch, CURLOPT_FOLLOWLOCATION, 1L);
  res = curl_easy_perform(ch);
}

七、curlhair意思

对于curl.h中的Curlhair，我们已经简单介绍过它的基本概念。但是实际上，它还涉及到许多其他的方面。如创建和检查Curlhair、读取和写入、重置和设置选项等等。下面是一些相关Curlhair的概念详细解释：

  • Curlhair创建: 使用curl_easy_init()函数可以创建一个Curlhair。需要注意的是每个Curlhair在使用完成后都需要被清空（使用curl_easy_cleanup()函数），否则可能会导致内存泄漏。
  • Curlhair选项: 可以使用curl_easy_setopt()函数设置和修改Curlhair选项。该函数接受两个参数：Curlhair句柄和选项。
  • Curlhair执行: 使用curl_easy_perform()函数可以执行一个Curlhair会话，实际完成Web请求。该函数返回一个CURLcode类型的结果，用于检查错误和异常情况。
  • Curlhair读写: 借助curl_easy_setopt()函数的CURLOPT_READFUNCTION选项，可以将数据传递给Web服务器。而CURLOPT_WRITEFUNCTION选项，则用于从服务器返回数据。该函数接受三个参数：curl头部，数据指针和数据大小。

八、curl和ping的区别

在Web编程中经常需要使用到Curl和Ping。它们各自有着自己的优缺点，应该根据场景需求而选择合适的工具。

  • Curl:
    • 优点：支持多种协议，包括HTTP、HTTPS、HTTP 2、FTP、TELNET、POP3、SMTP、IMAP、RTMP、RTSP、Gopher、DICT、LDAP、SMB、SCP、SFTP、TFTP、IRC。
    • 缺点：没有Ping命令这样的超具体协议处理。
    • 适用于：HTTP访问、文件上传下载、进程监控、服务管理等场景。
  • Ping:
    • 优点：超级具体的协议处理，具有极高的执行效率。
    • 缺点：只能检查是否能够连接到目标地址。
    • 适用于：网络连通性测试、连接测试等场景。

九、curl忽略ssl证书

有时候，使用curl.h连接仍然会出现认证错误或证书问题。可以使用下述方法让Curl忽略SSL验证来解决。

CURL *ch = curl_easy_init();
CURLEcode res;
if (ch) {
  curl_easy_setopt(ch, CURLOPT_URL, "https://example.com");
  curl_easy_setopt(ch, CURLOPT_SSL_VERIFYPEER, false);
  curl_easy_setopt(ch, CURLOPT_FOLLOWLOCATION, 1L);
  res = curl_easy_perform(ch);
}

十、curl和wget的区别

curl.h和Wget都是Web下载工具。他们都能够下载一个URL指定的文件，并且支持http、ftp、https协议。

  • Curl:
    • 优点：更加灵活，可编程性更好，支持多种协议。
    • 缺点：下载效率不如Wget。
  • Wget:
    • 优点：单个文件下载效率高，易用性好。
    • 缺点：不支持FTP的上传和管理、只支持HTTP和FTP协议。 总的来说，在Web编程中，Curl和Wget的选择应根据具体的任务和实现的标准来决定。
推荐文章