curl-g介紹

一、curl-g是什麼？

curl-g是一個基於curl庫的C++封裝庫，它支持多線程、異步、SSL加密、HTTP/HTTPS、FTP/SFTP等多種協議，提供了簡單易用的API接口。

curl-g主要解決了在使用原始curl庫時繁瑣的API調用、線程、連接池等問題。它簡化了C++開發者調用curl庫時對細節的控制，同時提供了更加高級的特性。

二、curl-g的安裝和使用

curl-g的安裝非常簡單，只需要執行以下命令即可：

git clone https://github.com/ngtech-ltd/curl-g.git
cd curl-g
mkdir build && cd build
cmake ..
make
make install

安裝成功後，我們可以開始使用curl-g了。下面是一個簡單的示例，它發起了一個HTTP GET請求，並打印出了響應的數據：

curl::easy easy;
easy.set_url("http://www.ngtech.tech");
easy.perform();
std::cout << easy.get_body();

上面的示例非常簡單。我們通過curl::easy類構造一個請求對象，設置請求的URL，調用perform()函數進行請求，調用get_body()函數獲取響應的數據，最後打印出來。

curl-g的易用性得益於它提供了易用的API接口。除了curl::easy類，curl-g還提供了其他幾個常用的類：

• curl::form：用於發送multipart/form-data類型的表單數據。
• curl::multi：用於發起多個請求。
• curl::share：用於共享curl庫中的資源，如DNS解析池、連接池等。

三、curl-g的高級特性

1. 多線程

curl-g支持在多個線程中並發使用。下面是一個簡單的示例，它在兩個線程中發起了HTTP GET請求：

curl::easy easy1, easy2;
easy1.set_url("http://www.ngtech.tech");
easy2.set_url("http://www.baidu.com");

std::thread t1([&](){
    easy1.perform();
    std::cout << easy1.get_body() << std::endl;
});

std::thread t2([&](){
    easy2.perform();
    std::cout << easy2.get_body() << std::endl;
});

t1.join();
t2.join();

在上面的示例中，我們創建了兩個curl::easy對象，然後在兩個線程中執行它們的perform()函數，並打印出響應結果。可以看到，curl-g支持多線程執行，非常方便。

2. 異步

curl-g還支持異步執行，可以用於實現高性能的請求。下面是一個使用curl::multi類異步執行三個HTTP GET請求的示例：

curl::multi multi;

curl::easy easy1, easy2, easy3;
easy1.set_url("https://www.ngtech.tech");
easy2.set_url("http://www.baidu.com");
easy3.set_url("http://www.google.com");

multi.add(easy1);
multi.add(easy2);
multi.add(easy3);

int still_running = multi.perform();
while (still_running) {
    still_running = multi.perform();
}

std::cout << easy1.get_body() << std::endl;
std::cout << easy2.get_body() << std::endl;
std::cout << easy3.get_body() << std::endl;

在上面的示例中，我們使用curl::multi類實例化一個多請求對象，然後通過調用add()函數添加三個curl::easy對象。接着，調用perform()函數異步執行三個請求，用一個while循環等待所有請求執行完畢。

3. SSL加密

curl-g支持SSL加密，可以用於HTTPS請求。在curl::easy類中，我們可以通過設置SSL證書、私鑰、CA證書等參數來進行HTTPS請求。下面是一個使用curl-g發起HTTPS請求的示例：

curl::easy easy;
easy.set_url("https://www.example.com");

curl::ssl_opts ssl_options;
ssl_options.set_cert("./client.pem",      // SSL證書路徑
                     "./client.key");     // SSL私鑰路徑
ssl_options.set_ca("./cacert.pem");       // SSL CA證書路徑
easy.set_ssl_opts(ssl_options);           // 設置SSL配置

easy.perform();
std::cout << easy.get_body() << std::endl;

在上面的示例中，我們使用curl::easy類發起了一個HTTPS請求。通過設置cert、key、ca三個參數，我們實現了對SSL證書的校驗和安全傳輸。

4. FTP/SFTP

curl-g不僅支持HTTP/HTTPS協議，還支持FTP/SFTP等協議。下面是一個使用curl::easy類下載FTP文件的示例：

curl::easy easy;
easy.set_url("ftp://ftp.freebsd.org/pub/FreeBSD/README.TXT");
easy.set_username("anonymous");     // 設置FTP用戶名
easy.set_password("foo@bar.com");   // 設置FTP密碼

curl::write_callback callback = [](char* data, size_t size, size_t nmemb, void* userdata) {
    std::ofstream* file = (std::ofstream*) userdata;
    file->write(data, size * nmemb);
    return size * nmemb;
};

std::ofstream file("README.TXT");   // 打開本地文件
easy.set_write_callback(callback, &file);     // 設置write回調函數

easy.perform();
file.close();

在上面的示例中，我們使用curl::easy類下載了一個FTP文件。通過設置FTP用戶名、密碼、write回調函數等參數，我們實現了文件的下載。

四、結論

curl-g是一個非常強大的C++網絡編程庫，它提供了易用的API接口和高級特性，可以用於實現多線程、異步、SSL加密、FTP/SFTP等功能。在項目開發中，使用curl-g可以大大提高開發效率，減少開發難度。