libcurl C++: पूर्ण गाइड उदाहरणों के साथ

libcurl क्या है और इसकी आवश्यकता क्यों है

libcurl एक शक्तिशाली और व्यापक रूप से उपयोग की जाने वाली क्रॉस-प्लेटफ़ॉर्म लाइब्रेरी है जो विभिन्न नेटवर्क प्रोटोकॉल पर डेटा ट्रांसफर करने के लिए उपयोग होती है। C में लिखी गई यह लाइब्रेरी C++ इंटरफ़ेस (जिसे अक्सर curlpp या libcurl का रैपर कहा जाता है) प्रदान करती है, जिससे HTTP रिक्वेस्ट, फ़ाइल डाउनलोड, FTP, SMTP और कई अन्य प्रोटोकॉल के साथ काम किया जा सकता है। C++ के संदर्भ में, libcurl HTTP क्लाइंट बनाने का डी-फैक्टो मानक है।

C++ में libcurl की आवश्यकता क्यों है?

• REST API के साथ काम करना: वेब सर्विसेज पर GET, POST, PUT, DELETE रिक्वेस्ट भेजना।
• फ़ाइल डाउनलोड करना: इंटरनेट से इमेज, डॉक्यूमेंट, आर्काइव डाउनलोड करना।
• डेटा भेजना: सर्वर पर फ़ाइल अपलोड करना, फ़ॉर्म सबमिट करना।
• वेब पेज पार्स करना: आगे के विश्लेषण के लिए HTML कोड प्राप्त करना।
• प्रमाणीकरण: Basic, Digest, OAuth, NTLM और अन्य स्कीम का समर्थन।
• कुकीज़ के साथ काम करना: सेशन और स्टेट मैनेजमेंट।
• SSL/TLS: HTTPS के माध्यम से सुरक्षित कनेक्शन।

यह लाइब्रेरी उच्च प्रदर्शन, स्थिरता और लगभग सभी आधुनिक नेटवर्क प्रोटोकॉल के समर्थन के लिए जानी जाती है। इसका उपयोग cURL (कमांड लाइन), PHP (cURL एक्सटेंशन) और कई अन्य प्रोजेक्ट्स में किया जाता है।

C++ के लिए libcurl इंस्टॉलेशन

Python या JavaScript के विपरीत, C++ में कोई एकल पैकेज मैनेजर नहीं है, इसलिए इंस्टॉलेशन आपके ऑपरेटिंग सिस्टम और कंपाइलर पर निर्भर करता है।

Linux (Ubuntu/Debian) पर इंस्टॉलेशन

sudo apt update
sudo apt install libcurl4-openssl-dev

अन्य डिस्ट्रीब्यूशन (Fedora, CentOS, Arch) के लिए संबंधित पैकेज मैनेजर (dnf, yum, pacman) का उपयोग करें।

macOS पर इंस्टॉलेशन

brew install curl

Windows पर इंस्टॉलेशन

सबसे आसान तरीका vcpkg का उपयोग करना है:

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
.\bootstrap-vcpkg.bat
.\vcpkg integrate install
.\vcpkg install curl

या curl की आधिकारिक वेबसाइट से पहले से बिल्ट बाइनरी डाउनलोड करें।

CMake प्रोजेक्ट में कनेक्ट करना

find_package(CURL REQUIRED)
target_link_libraries(your_project PRIVATE CURL::libcurl)

त्वरित शुरुआत: सरल HTTP GET रिक्वेस्ट

चलिए एक सरल प्रोग्राम लिखते हैं जो किसी वेबसाइट पर GET रिक्वेस्ट करता है और प्राप्त डेटा को प्रिंट करता है।

#include <iostream>
#include <string>
#include <curl/curl.h>

// डेटा को स्ट्रिंग में लिखने के लिए कॉलबैक फंक्शन
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    size_t totalSize = size * nmemb;
    output->append(static_cast<char*>(contents), totalSize);
    return totalSize;
}

int main() {
    CURL* curl;
    CURLcode res;
    std::string response;

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://api.github.com");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
        
        // रिक्वेस्ट करें
        res = curl_easy_perform(curl);
        
        if (res != CURLE_OK) {
            std::cerr << "त्रुटि: " << curl_easy_strerror(res) << std::endl;
        } else {
            std::cout << "सर्वर का जवाब:" << std::endl;
            std::cout << response << std::endl;
        }
        
        curl_easy_cleanup(curl);
    }

    curl_global_cleanup();
    return 0;
}

कंपाइलेशन:

g++ -o http_client http_client.cpp -lcurl

libcurl के मुख्य मेथड/फंक्शन

1. curl_easy_init