CURLcode curl_global_init(long flags); //這個(gè)函數(shù)只能用一次。(調(diào)用curl_global_cleanup清理后可再次使用初始化)
//參數(shù)：flags
 	//CURL_GLOBAL_ALL: 初始化所有的 libcurl 功能。
 	//CURL_GLOBAL_SSL: 初始化 SSL 相關(guān)的功能，如支持 HTTPS 議。
 	//CURL_GLOBAL_WIN32: 在 Windows 平臺(tái)上初始化一些特定的功能。
 	//CURL_GLOBAL_NOTHING: 不做任何初始化，這種情況下需要手動(dòng)初始化特定的功能。
//返回值： CURLcode 類(lèi)型的錯(cuò)誤碼，如果初始化成功則返回 CURLE_OK，否則返回其他錯(cuò)誤碼表示初始化失敗

curl_easy_setopt(curl, CURLOPT_URL, url.data());   // 設(shè)置要下載的URL地址
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);   // 設(shè)置回調(diào)函數(shù)以將數(shù)據(jù)寫(xiě)入文件
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &downloadData);   // 傳遞包含輸出文件指針、進(jìn)度等的結(jié)構(gòu)體給回調(diào)函數(shù)

CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);
	//參數(shù)：
	//	- handle: 指向 CURL 句柄的指針，表示要設(shè)置選項(xiàng)的 CURL 句柄。
	//	- option: 枚舉類(lèi)型 CURLoption，表示要設(shè)置的選項(xiàng)類(lèi)型。
	//	- parameter: 選項(xiàng)對(duì)應(yīng)的參數(shù)值，類(lèi)型根據(jù)不同選項(xiàng)而定，既可以是個(gè)函數(shù)的指針,也可以是某個(gè)對(duì)象的指針,也可以是個(gè)long型的變量
	常見(jiàn)CURLoption類(lèi)型(更多CURLoption類(lèi)型的選項(xiàng)都在curl.h庫(kù)里有定義,man 也可以查看到)：
		CURLOPT_URL: 設(shè)置請(qǐng)求的 URL。
		CURLOPT_HTTPHEADER: 設(shè)置請(qǐng)求頭信息。
		CURLOPT_POSTFIELDS: 設(shè)置請(qǐng)求體數(shù)據(jù)。
		CURLOPT_TIMEOUT: 設(shè)置請(qǐng)求超時(shí)時(shí)間。
		CURLOPT_WRITEFUNCTION: 設(shè)置寫(xiě)數(shù)據(jù)回調(diào)函數(shù)。
		CURLOPT_WRITEDATA: 設(shè)置寫(xiě)數(shù)據(jù)回調(diào)函數(shù)的用戶(hù)數(shù)據(jù)。
		CURLOPT_PROXY: 設(shè)置代理服務(wù)器地址。
		CURLOPT_SSL_VERIFYPEER: 設(shè)置是否驗(yàn)證對(duì)等證書(shū)。
		CURLOPT_SSL_VERIFYHOST: 設(shè)置是否驗(yàn)證主機(jī)名。
		CURLOPT_CUSTOMREQUEST: 設(shè)置自定義請(qǐng)求方法。
		CURLOPT_USERAGENT: 設(shè)置用戶(hù)代理信息。
		CURLOPT_VERBOSE: 設(shè)置是否輸出詳細(xì)的調(diào)試信息。
		CURLOPT_FOLLOWLOCATION: 設(shè)置是否跟隨重定向。
		CURLOPT_COOKIE: 設(shè)置請(qǐng)求中的 Cookie。
		CURLOPT_COOKIEFILE: 設(shè)置從文件中讀取 Cookie。
		CURLOPT_COOKIEJAR: 設(shè)置保存 Cookie 到文件。
		CURLOPT_RESUME_FROM: 設(shè)置斷點(diǎn)續(xù)傳的起始位置。
		CURLOPT_LOW_SPEED_LIMIT: 設(shè)置低速下載速度限制。
		CURLOPT_LOW_SPEED_TIME: 設(shè)置低速下載持續(xù)時(shí)間。
		CURLOPT_CONNECTTIMEOUT: 設(shè)置連接超時(shí)時(shí)間
	
	例如：
	struct curl_slist *headers = NULL;
	headers = curl_slist_append(headers, "Content-Type: application/json");
	curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);	//設(shè)置請(qǐng)求頭
	curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");	//設(shè)置 URL
	curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "key1=value1&key2=value2");	//設(shè)置請(qǐng)求體
	curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L); // 設(shè)置請(qǐng)求超時(shí)時(shí)間,超時(shí)時(shí)間為10秒
	curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);//設(shè)置寫(xiě)數(shù)據(jù)回調(diào)函數(shù)
	curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);//設(shè)置回調(diào)函數(shù)用戶(hù)數(shù)據(jù)
	curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy.example.com:8080");	//設(shè)置代理
	curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); //設(shè)置 SSL 選項(xiàng), 禁止驗(yàn)證對(duì)等證書(shū)

size_t write_callback(char *ptr, size_t size, size_t nmemb, void *userdata);
//參數(shù)：
	- ptr 是接收到的數(shù)據(jù)緩沖區(qū)指針，
	- size 是單個(gè)數(shù)據(jù)塊的大小，
	- nmemb 是數(shù)據(jù)塊的數(shù)量，
	- userdata 是傳遞給 CURLOPT_WRITEDATA 的用戶(hù)數(shù)據(jù)指針。
//返回值：回調(diào)函數(shù)返回接收到的數(shù)據(jù)大小。

int progress_callback(void *clientp, double dltotal, double dlnow, double ultotal, double ulnow);
//參數(shù)：
	- clientp 是傳遞給 `CURLOPT_PROGRESSDATA` 的用戶(hù)數(shù)據(jù)指針，
	- dltotal 是預(yù)期下載總字節(jié)數(shù)，
	- dlnow 是當(dāng)前已下載字節(jié)數(shù)，
	- ultotal 是預(yù)期上傳總字節(jié)數(shù)，
	- ulnow 是當(dāng)前已上傳字節(jié)數(shù)。
//返回值：回調(diào)函數(shù)應(yīng)該返回 0 以繼續(xù)下載操作，返回非零值表示終止下載操作。

if (res != CURLE_OK) {
    fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
} else {    // 請(qǐng)求成功，處理響應(yīng)數(shù)據(jù)  }

//以下是一些常用的 CURLcode 枚舉值,詳細(xì)的錯(cuò)誤描述字符串，可以通過(guò)const char *curl_easy_strerror(CURLcode errornum ) 這個(gè)函數(shù)取得
CURLE_OK (0): 操作成功完成。
CURLE_UNSUPPORTED_PROTOCOL (1): 不支持的協(xié)議。
CURLE_URL_MALFORMAT (3): URL 格式錯(cuò)誤。
CURLE_COULDNT_RESOLVE_HOST (6): 無(wú)法解析主機(jī)名。
CURLE_COULDNT_CONNECT (7): 無(wú)法連接到主機(jī)或代理。
CURLE_OPERATION_TIMEDOUT (28): 操作超時(shí)。
CURLE_SSL_CONNECT_ERROR (35): SSL/TLS 連接錯(cuò)誤。
CURLE_PEER_FAILED_VERIFICATION (51): 對(duì)等證書(shū)驗(yàn)證失敗。
CURLE_GOT_NOTHING (52): 未收到任何數(shù)據(jù)。
CURLE_SEND_ERROR (55): 發(fā)送數(shù)據(jù)時(shí)出錯(cuò)。
CURLE_RECV_ERROR (56): 接收數(shù)據(jù)時(shí)出錯(cuò)。
CURLE_SSL_CERTPROBLEM (58): 證書(shū)問(wèn)題。
CURLE_SSL_CIPHER (59): SSL/TLS 密碼錯(cuò)誤。
CURLE_SSL_CACERT (60): 未找到合適的 CA 證書(shū)。
CURLE_USE_SSL_FAILED (64): 使用 SSL/TLS 失敗。

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


struct DownloadData {
	FILE *file = nullptr; // 聲明為 null ;
	s32 fileSize;
	s32 downloaded;
	std::string hash;
	bool isInitialized = false;
};

// 定義寫(xiě)數(shù)據(jù)回調(diào)函數(shù)
size_t HttpDownloadService::WriteCallback(void *contents, size_t size, size_t nmemb, void *userp) {
	// size_t data_size = size * nmemb; // 計(jì)算本次寫(xiě)入的數(shù)據(jù)總大小(size是單個(gè)數(shù)據(jù)塊大小,nmemb是塊的數(shù)量)
   	// 獲取傳遞進(jìn)來(lái)的DownloadData結(jié)構(gòu)體指針
   	struct DownloadData *downloadData = (struct DownloadData *) userp;
   // 將數(shù)據(jù)塊寫(xiě)入文件,返回實(shí)際寫(xiě)入的大小
    size_t write_size = fwrite(contents, size, nmemb, downloadData->file);
  	downloadData->downloaded += write_size;  // 更新已下載的總字節(jié)數(shù)
   	if (downloadData->fileSize > 0) {
     	downloaded = downloadData->downloaded;
        double progress = (double) downloadData->downloaded / downloadData->fileSize * 100; 
        std::cout << " Download fileSize: " << downloadData->fileSize << "  Download Progress: " << progress << "%" << std::endl;
      }
   	return write_size;
}
        
int main() {
      curl_global_init(CURL_GLOBAL_ALL);// 初始化CURL庫(kù)
      CURL *curl = curl_easy_init();  // 獲取一個(gè)CURL句柄用于本次傳輸    
      if (curl) {      
     	const char *outputFileName = "aaa.txt";
        struct DownloadData downloadData;
        // 以二進(jìn)制寫(xiě)模式打開(kāi)輸出文件
        downloadData.file = fopen(outputFileName, "wb"); // Open the file and get FILE* pointer
        downloadData.fileSize = 7022;  // 預(yù)期的總文件大小,字節(jié)數(shù)
        downloadData.downloaded = 0;    // 已下載的字節(jié)數(shù)
        downloadData.hash = "8b32dbbdfcffc01ae7ff4cd29c9e4bfa973e9df29a629c80605d374d4237e2ba"; // 預(yù)期的下載文件SHA256哈希值
        
        curl_easy_setopt(curl, CURLOPT_URL, “http://example.com”);   // 設(shè)置要下載的URL地址
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);   // 設(shè)置回調(diào)函數(shù)以將數(shù)據(jù)寫(xiě)入文件
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &downloadData);   // 傳遞包含輸出文件指針、進(jìn)度等的結(jié)構(gòu)體給回調(diào)函數(shù)
        curl_easy_setopt(curl, CURLOPT_NOPROGRESS, 0);   // 啟用進(jìn)度回調(diào)
        curl_easy_setopt(curl, CURLOPT_PROGRESSFUNCTION, nullptr);  // 進(jìn)度回調(diào)函數(shù)可選,這里不使用
        curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3);

      		CURLcode res = curl_easy_perform(curl);  // 執(zhí)行請(qǐng)求
        if (res != CURLE_OK) {
        	// 請(qǐng)求失敗，處理錯(cuò)誤
             std::cout << "Download failed: {}: " << curl_easy_strerror(res)<< std::endl;
        } else {
         	// 請(qǐng)求成功，處理響應(yīng)數(shù)據(jù)
            logger->Info(SRC_LOC, "Download completed successfully.");
            std::cout << "Download completed successfully. " << std::endl;
            //……eg：對(duì)比文件大小和hash檢查下載文件是否正常
        }

        curl_easy_cleanup(curl);    // 清理CURL句柄資源
        fclose(downloadData.file); // Close the file
      }
       
    curl_global_cleanup();  // 清理CURL庫(kù)資源
    return 0;
}