C++使用libcurl做HttpClient

最新推荐文章于 2025-09-13 13:18:35 发布
原创 最新推荐文章于 2025-09-13 13:18:35 发布 · 10w+ 阅读 · 133 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#c++ #string #null #ssl #header #url

    当使用C++做HTTP客户端时，目前通用的做法就是使用libcurl。其官方网站的地址是http://curl.haxx.se/，该网站主要提供了Curl和libcurl。Curl是命令行工具，用于完成FTP, FTPS, HTTP, HTTPS, GOPHER, TELNET, DICT, FILE 以及 LDAP的命令的请求及接收回馈。libcurl提供给开发者，用于使用C++跨平台的开发各种网络协议的请求及响应。里面的文档非常齐全，不过都是英文的。

    本文提供最简单的demo使用libcurl开发HttpClient。主要包括同步的HTTP GET、HTTP POST、HTTPS GET、HTTPS POST。

    下载libcurl包，如果使用Linux平台，建议下载源文件编译；如果使用Windows平台，建议下载Win32 - MSVC，下载地址是：http://curl.haxx.se/download.html

#ifndef __HTTP_CURL_H__
#define __HTTP_CURL_H__

#include <string>

class CHttpClient
{
public:
	CHttpClient(void);
	~CHttpClient(void);

public:
	/**
	* @brief HTTP POST请求
	* @param strUrl 输入参数,请求的Url地址,如:http://www.baidu.com
	* @param strPost 输入参数,使用如下格式para1=val1¶2=val2&…
	* @param strResponse 输出参数,返回的内容
	* @return 返回是否Post成功
	*/
	int Post(const std::string & strUrl, const std::string & strPost, std::string & strResponse);

	/**
	* @brief HTTP GET请求
	* @param strUrl 输入参数,请求的Url地址,如:http://www.baidu.com
	* @param strResponse 输出参数,返回的内容
	* @return 返回是否Post成功
	*/
	int Get(const std::string & strUrl, std::string & strResponse);

	/**
	* @brief HTTPS POST请求,无证书版本
	* @param strUrl 输入参数,请求的Url地址,如:https://www.alipay.com
	* @param strPost 输入参数,使用如下格式para1=val1¶2=val2&…
	* @param strResponse 输出参数,返回的内容
	* @param pCaPath 输入参数,为CA证书的路径.如果输入为NULL,则不验证服务器端证书的有效性.
	* @return 返回是否Post成功
	*/
	int Posts(const std::string & strUrl, const std::string & strPost, std::string & strResponse, const char * pCaPath = NULL);

	/**
	* @brief HTTPS GET请求,无证书版本
	* @param strUrl 输入参数,请求的Url地址,如:https://www.alipay.com
	* @param strResponse 输出参数,返回的内容
	* @param pCaPath 输入参数,为CA证书的路径.如果输入为NULL,则不验证服务器端证书的有效性.
	* @return 返回是否Post成功
	*/
	int Gets(const std::string & strUrl, std::string & strResponse, const char * pCaPath = NULL);

public:
	void SetDebug(bool bDebug);

private:
	bool m_bDebug;
};

#endif


#include "httpclient.h"
#include "curl/curl.h"
#include <string>

CHttpClient::CHttpClient(void) : 
m_bDebug(false)
{

}

CHttpClient::~CHttpClient(void)
{

}

static int OnDebug(CURL *, curl_infotype itype, char * pData, size_t size, void *)
{
	if(itype == CURLINFO_TEXT)
	{
		//printf("[TEXT]%s\n", pData);
	}
	else if(itype == CURLINFO_HEADER_IN)
	{
		printf("[HEADER_IN]%s\n", pData);
	}
	else if(itype == CURLINFO_HEADER_OUT)
	{
		printf("[HEADER_OUT]%s\n", pData);
	}
	else if(itype == CURLINFO_DATA_IN)
	{
		printf("[DATA_IN]%s\n", pData);
	}
	else if(itype == CURLINFO_DATA_OUT)
	{
		printf("[DATA_OUT]%s\n", pData);
	}
	return 0;
}

static size_t OnWriteData(void* buffer, size_t size, size_t nmemb, void* lpVoid)
{
	std::string* str = dynamic_cast<std::string*>((std::string *)lpVoid);
	if( NULL == str || NULL == buffer )
	{
		return -1;
	}

    char* pData = (char*)buffer;
    str->append(pData, size * nmemb);
	return nmemb;
}

int CHttpClient::Post(const std::string & strUrl, const std::string & strPost, std::string & strResponse)
{
	CURLcode res;
	CURL* curl = curl_easy_init();
	if(NULL == curl)
	{
		return CURLE_FAILED_INIT;
	}
	if(m_bDebug)
	{
		curl_easy_setopt(curl, CURLOPT_VERBOSE, 1);
		curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, OnDebug);
	}
	curl_easy_setopt(curl, CURLOPT_URL, strUrl.c_str());
	curl_easy_setopt(curl, CURLOPT_POST, 1);
	curl_easy_setopt(curl, CURLOPT_POSTFIELDS, strPost.c_str());
	curl_easy_setopt(curl, CURLOPT_READFUNCTION, NULL);
	curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, OnWriteData);
	curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)&strResponse);
	curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1);
	curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3);
	curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);
	res = curl_easy_perform(curl);
	curl_easy_cleanup(curl);
	return res;
}

int CHttpClient::Get(const std::string & strUrl, std::string & strResponse)
{
	CURLcode res;
	CURL* curl = curl_easy_init();
	if(NULL == curl)
	{
		return CURLE_FAILED_INIT;
	}
	if(m_bDebug)
	{
		curl_easy_setopt(curl, CURLOPT_VERBOSE, 1);
		curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, OnDebug);
	}

	curl_easy_setopt(curl, CURLOPT_URL, strUrl.c_str());
	curl_easy_setopt(curl, CURLOPT_READFUNCTION, NULL);
	curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, OnWriteData);
	curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)&strResponse);
	/**
	* 当多个线程都使用超时处理的时候，同时主线程中有sleep或是wait等操作。
	* 如果不设置这个选项，libcurl将会发信号打断这个wait从而导致程序退出。
	*/
	curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1);
	curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3);
	curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);
	res = curl_easy_perform(curl);
	curl_easy_cleanup(curl);
	return res;
}

int CHttpClient::Posts(const std::string & strUrl, const std::string & strPost, std::string & strResponse, const char * pCaPath)
{
	CURLcode res;
	CURL* curl = curl_easy_init();
	if(NULL == curl)
	{
		return CURLE_FAILED_INIT;
	}
	if(m_bDebug)
	{
		curl_easy_setopt(curl, CURLOPT_VERBOSE, 1);
		curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, OnDebug);
	}
	curl_easy_setopt(curl, CURLOPT_URL, strUrl.c_str());
	curl_easy_setopt(curl, CURLOPT_POST, 1);
	curl_easy_setopt(curl, CURLOPT_POSTFIELDS, strPost.c_str());
	curl_easy_setopt(curl, CURLOPT_READFUNCTION, NULL);
	curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, OnWriteData);
	curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)&strResponse);
	curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1);
	if(NULL == pCaPath)
	{
		curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, false);
		curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, false);
	}
	else
	{
		//缺省情况就是PEM，所以无需设置，另外支持DER
		//curl_easy_setopt(curl,CURLOPT_SSLCERTTYPE,"PEM");
		curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, true);
		curl_easy_setopt(curl, CURLOPT_CAINFO, pCaPath);
	}
	curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3);
	curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);
	res = curl_easy_perform(curl);
	curl_easy_cleanup(curl);
	return res;
}

int CHttpClient::Gets(const std::string & strUrl, std::string & strResponse, const char * pCaPath)
{
	CURLcode res;
	CURL* curl = curl_easy_init();
	if(NULL == curl)
	{
		return CURLE_FAILED_INIT;
	}
	if(m_bDebug)
	{
		curl_easy_setopt(curl, CURLOPT_VERBOSE, 1);
		curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, OnDebug);
	}
	curl_easy_setopt(curl, CURLOPT_URL, strUrl.c_str());
	curl_easy_setopt(curl, CURLOPT_READFUNCTION, NULL);
	curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, OnWriteData);
	curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)&strResponse);
	curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1);
	if(NULL == pCaPath)
	{
		curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, false);
		curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, false);
	}
	else
	{
		curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, true);
		curl_easy_setopt(curl, CURLOPT_CAINFO, pCaPath);
	}
	curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3);
	curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);
	res = curl_easy_perform(curl);
	curl_easy_cleanup(curl);
	return res;
}

///////////////////////////////////////////////////////////////////////////////////////////////

void CHttpClient::SetDebug(bool bDebug)
{
	m_bDebug = bDebug;
}











                

        

    

  



    



                



	

		

			

				
					
c++库：libcurl

				
			

			

				

					onj123的博客
				

				

					01-07
					
					924
					
				

			

		

		

			
				
libcurl
是一个跨平台的网络协议库，支持http, https, ftp, gopher, telnet, dict, file, 和ldap 协议。libcurl同样支持HTTPS证书授权，HTTP POST, HTTP PUT, FTP 上传, HTTP基本表单上传，代理，cookies和用户认证
官网： https://curl.haxx.se/
安装
1. 下载：https://cu...

			
		

	



                

            
              



	

		

			

				
					
HTTP Client C++实现

				
			

			

				

					01-15
				

			

		

		

			
				
CHttpClient.rar
HTTP Client C++实现

			
		

	



              


  
              

                


	

		

			

				
					
轻量级C++实现的httpserver和httpclient

				
			

			

				

					03-17
				

			

		

		

			
				
轻量级C++实现的httpserver和httpclient，给予mongoose，代码量很小，可以方便嵌入到自己的项目中，为C++项目添加http的功能，抛弃libcurl这种重型库

			
		

	





	

		

			

				
					
C++中使用libcurl库实现HTTP数据传输详解与代码实例

					
最新发布

				
			

			

				

					weixin_30248619的博客
				

				

					09-13
					
					1213
					
				

			

		

		

			
				
在现代软件开发中，网络通信已成为不可或缺的一部分。尤其在构建高性能、低延迟的分布式系统、实现远程数据交互、开发基于HTTP协议的客户端与服务端应用时，C++作为系统级语言的优势得以充分展现。其直接操作底层网络接口的能力，配合高效的内存管理机制，使得C++成为网络编程的理想选择。本章将从网络通信的基本概念出发，介绍TCP/IP协议栈在C++中的编程模型，深入剖析HTTP协议的请求-响应机制，并阐述C++进行网络编程的常见方式与技术选型，为后续学习libcurl库的使用打下坚实的理论基础。

			
		

	



		

			
		



	

		

			

				
					
c++ http通讯 基于mongoose 的httpserver和httpclient

				
			

			

				

					09-27
				

			

		

		

			
				
c++ http通讯 基于mongoose 的httpserver和httpclient。Mongoose是一个轻量化的web服务器，通过提供一个web接口给它，它可以嵌入到现有的工程当中。Mongoose的整个代码只有一个c文件和一个h文件，使用起来非常方便。...

			
		

	





	

		

			

				
					
C++/CLI应用程序调用httpClient请求HTTP和用Newtonsoft解析json示例代码

				
			

			

				

					02-09
				

			

		

		

			
				
现在C++也不行了吗，网上找不到相关代码。为了搞清楚C++中如何使用httpClient和Newtonsoft，研究了一下午。我从未用C++编程，一直用C#，现学现卖。

			
		

	





	

		

			

				
					
c/c++调用libcurl库发送http请求的两种基本用法

					
热门推荐

				
			

			

				

					小麒麟的成长之路
				

				

					12-30
					
					4万+
					
				

			

		

		

			
				
libcurl主要提供了两种发送http请求的方式，分别是Easy interface方式和multi interface方式，前者是采用阻塞的方式发送单条数据，后者采用组合的方式可以一次性发送多条数据
一、Easy interface

libcurl的easy interface是最基本的用法，首先调用curl_easy_init获取一个句柄，curl_easy_setopt函数用来设置

			
		

	





	

		

			

				
					
c++中libcurl库

				
			

			

				

					05-18
				

			

		

		

			
				
libcurl

			
		

	





	

		

			

				
					
libcurl库（C++）快速使用

				
			

			

				

					weixin_34214500的博客
				

				

					05-15
					
					285
					
				

			

		

		

			
				
---恢复内容开始---
libcurl是一个跨平台的网络协议库，支持http, https, ftp, gopher, telnet, dict, file, 和ldap 协议。libcurl同样支持HTTPS证书授权，HTTP POST, HTTP PUT, FTP 上传, HTTP基本表单上传，代理，cookies,和用户认证。
win32版的libcurl下载地址:http://cur...

			
		

	





	

		

			

				
					
C++编程——LIBCURL

				
			

			

				

					gccflagger的博客
				

				

					12-04
					
					1361
					
				

			

		

		

			
				
众所周知，libcurl是一个强大的网络库。下面我们就来说一下怎么在Windows和Linux上实现对libcurl的调用。

  一、Windows

  在Windows上需要根据不同的系统版本(Win32或Win64)下载不同的libcurl库。如果你是WIN32程序，可以从我的资源库libcurl SDK WIN32下载。

如果你是64位的，可以从CURL的官网下载：https://curl.haxx.se/download.html。

  下载到libcurl sdk之后...

			
		

	





	

		

			

				
					
c++ LibCurl编程

				
			

			

				

					beyondlpf的专栏
				

				

					03-30
					
					1230
					
				

			

		

		

			
				
LibCurl编程
2.1 LibCurl编程流程
在基于LibCurl的程序里，主要采用callback function
（回 调函数）的形式完成传输任务，用户在启动传输前设置好各类参数和回调函数，当满足条件时libcurl将调用用户的回调函数实现特定功能。下面是利用libcurl完成传输任务的流程：
1.      调用curl_global_init()初始化libcurl
2.

			
		

	





	

		

			

				
					
C++中使用libcurl做httpclient通信

				
			

			

				

					qq_30236169的博客
				

				

					07-02
					
					396
					
				

			

		

		

			
				
参考：http://www.360doc.com/content/15/0617/18/3242454_478805702.shtml

参考以上博客后，写了自己的post函数，使用中注意格式转换。

HttpClient.h


#pragma once
#include <string>

class HttpClient
{
public:
	HttpClient();
	~Ht...

			
		

	





	

		

			

				
					
基于libcurl实现的HTTP客户端

				
			

			

				

					HW的博客
				

				

					06-27
					
					6740
					
				

			

		

		

			
				
libcurl安装

libcurl的编译安装请参考博客https://blog.csdn.net/gg_simida/article/details/80536860

HttpClient

我们的目标是封装一个HttpClient类，支持GET、POST或者自定义方法，支持发送和接受文本、json、xml、form-data、x-www-form-urlencoded数据，支持自定义头部He...

			
		

	





	

		

			

				
					
libcurl，一个不可或缺的 C++ 网络库！

				
			

			

				

					一行玩python
				

				

					12-20
					
					1068
					
				

			

		

		

			
				
宝子们，今天咱来学习 libcurl 这个超厉害的 C++ 网络库。它就像是我们在网络世界里的“快递员”，能帮我们轻松地发送和接收各种网络数据，无论是下载文件、上传数据，还是和服务器进行各种交互，它都能搞定，让我们的 C++ 程序在网络的海洋里畅游无阻。一、libcurl 基础概念什么是 libcurl 呢？ 简单来说，它是一个功能强大的网络库，提供了一系列简单易用的函数，让我们可以方便地进行各种...

			
		

	





	

		

			

				
					
C++ libcurl 使用

				
			

			

				

					长夜大雨
				

				

					06-05
					
					1513
					
				

			

		

		

			
				
最近一直在C++&HTTP的环境下工作，需要各种高级特性，包括HTTP&JSON，在网上找到一些资料，转载于此 
   转载出处： http://blog.csdn.net/huyiyang2010/article/details/7664201
当使用C++做HTTP客户端时，目前通用的做法就是使用libcurl。其官方网站的地址是http://curl.haxx.se/，该网站主要提供了Curl

			
		

	





	

		

			

				
					
libcurl


				
			

			

				

					09-10
				

			

		

		

			
				
### 功能介绍
Libcurl 是一个功能强大的开源库，支持多种协议，包括 HTTP、HTTPS、FTP、SMTP 等。它允许程序与服务器进行数据传输，可用于下载文件、上传数据、发送 HTTP 请求等操作。通过提供统一的 API，开发者可以方便地实现与不同协议服务器的交互，而无需关心底层的网络细节。例如，在进行文件下载时，只需要设置好 URL 和保存路径，libcurl 就能自动完成连接、传输和保存的过程。

### 使用指南

#### 安装
在不同的操作系统上，安装 libcurl 的方式有所不同。
- **Ubuntu/Debian**：
```bash
sudo apt-get install libcurl4-openssl-dev
```
- **CentOS/RHEL**：
```bash
sudo yum install libcurl-devel
```
- **macOS**：可以使用 Homebrew 进行安装
```bash
brew install curl
```

#### 简单示例（C 语言）
以下是一个使用 libcurl 进行 HTTP GET 请求的简单示例：
```c
#include <stdio.h>
#include <curl/curl.h>

size_t write_callback(void *contents, size_t size, size_t nmemb, void *userp) {
    size_t realsize = size * nmemb;
    printf("%.*s", (int)realsize, (char *)contents);
    return realsize;
}

int main(void) {
    CURL *curl;
    CURLcode res;

    curl = curl_easy_init();
    if(curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
        res = curl_easy_perform(curl);
        if(res != CURLE_OK)
            fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
        curl_easy_cleanup(curl);
    }
    return 0;
}
```
编译和运行：
```bash
gcc -o example example.c -lcurl
./example
```

### 常见问题解决方案

#### 证书验证失败
当使用 HTTPS 协议时，可能会遇到证书验证失败的问题。可以通过设置 `CURLOPT_SSL_VERIFYPEER` 和 `CURLOPT_SSL_VERIFYHOST` 选项来临时绕过证书验证，但在生产环境中不建议这样做。
```c
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);
```

#### 超时问题
如果请求长时间没有响应，可以设置超时时间：
```c
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L); // 设置超时时间为 10 秒
```



			
		

	



              




          




        



    





    



      

      

        
      

      





	

		
评论 25

	

  
	




  

    

      添加红包
      
    

    

      

        
        

          
          
        

        
请填写红包祝福语或标题

      

      

        
        

          
          个
        

        
红包个数最小为10个

      

      

        
        

          
          元
        

        
红包金额最低5元

      

      

        
        

          当前余额3.43元
          前往充值 >
        

      

      

        

          需支付：10.00元
        

        
        
      

    

  





  

    
    
  

  

    
    
  








  

    

      

        

          

            
            
成就一亿技术人!

          

          

        

        

          

          

            领取后你会自动成为博主和红包主的粉丝
            规则
          

        

      

      

        

          

            
              
            
            

              
hope_wisdom
 发出的红包
            

          

        

        

          

          

          

        

      

    

    

  



      
      

      
实付元

      
使用余额支付

      

        

          

            
            点击重新获取
          

        

        
扫码支付

      

      

        
          
            
          
          
        
      

      

        
        钱包余额
          0
          

            
            

              

                
抵扣说明：

                
 1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
 2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

              

            

          

      

      余额充值