curl-ді C тіліне түрлендіру

Q: libcurl дегеніміз не?

libcurl — бұл curl командалық жол құралының негізінде жатқан C кітапханасы. Бұл 25-тен астам хаттаманы қолдайтын, әлемдегі ең портативті және кеңінен таралған HTTP клиенттік кітапханасы. Мыңдаған қолданбалар мен ендірілген жүйелерде қолданылады. Жүйелік пакет менеджері арқылы қосыңыз немесе статикалық түрде байланыстырыңыз. curl2code жеңіл интерфейсті қолдана отырып libcurl C кодын жасайды.

Q: libcurl easy vs multi интерфейсі — қайсысын қолданған жөн?

Easy интерфейсі (curl_easy_*) бір синхронды тасымалдауға арналған — қарапайым және түсінікті. Multi интерфейсі (curl_multi_*) бір ағында блоктамайтын конкурентті тасымалдауға мүмкіндік береді. Скрипттер мен қарапайым құралдар үшін easy, жоғары өнімді қолданбалар үшін multi қолданыңыз. Жоғары деңгейлі C-тұқымдас тіл үшін curl-ден Rust-қа қараңыз.

Q: libcurl-мен аутентификацияны қалай өңдеуге болады?

Bearer үшін: curl_slist_append(headers, "Authorization: Bearer token") арқылы реттелетін тақырып орнатыңыз. Basic auth үшін: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl Basic auth деректерін автоматты түрде кодтайды. curl2code -u және тақырып жалаушаларын дұрыс C API шақыруларына түрлендіреді.

Q: libcurl-мен қателерді қалай өңдеуге болады?

Әрбір curl_easy_* функциясы CURLcode қайтарады — оны CURLE_OK-мен салыстырып тексеріңіз. Адам оқи алатын хабарламалар үшін curl_easy_strerror(code) қолданыңыз. Толық қате жолдары үшін CURLOPT_ERRORBUFFER орнатыңыз. HTTP күйін curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code) арқылы алыңыз.

Q: libcurl-мен жадты қалай басқаруға болады?

Тұтқамен (handle) жұмыс аяқталғанда әрқашан curl_easy_cleanup() шақырыңыз. Тақырыптар тізімін curl_slist_free_all() арқылы босатыңыз. MIME құрылымдарын curl_mime_free() арқылы босатыңыз. Жазу кері байланыстары (write callbacks) үшін жеке буфер бөлуді басқарыңыз. Бағдарлама аяқталғанда бір рет curl_global_cleanup() шақырыңыз. Ресурстарды босатпау жадтың ағып кетуіне әкеледі.

Q: libcurl-мен күту уақытын қалай орнатуға болады?

Қосылу күту уақыты үшін CURLOPT_CONNECTTIMEOUT және жалпы тасымалдау уақыты үшін CURLOPT_TIMEOUT орнатыңыз (екеуі де секундпен). Миллисекундтық дәлдік үшін CURLOPT_CONNECTTIMEOUT_MS және CURLOPT_TIMEOUT_MS қолданыңыз. Бұл curl CLI-дегі --connect-timeout және --max-time опцияларымен бірдей.

Q: libcurl-мен проксиді қалай баптауға болады?

CURLOPT_PROXY мәнін прокси URL-іне орнатыңыз: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). SOCKS5 үшін: CURLOPT_PROXYTYPE мәнін CURLPROXY_SOCKS5 етіп орнатыңыз. Прокси аутентификациясы үшін: CURLOPT_PROXYUSERPWD. libcurl сонымен қатар http_proxy орта айнымалысын ескереді.

Q: C тілінде JSON денесі бар POST сұрауын қалай жіберуге болады?

curl2code құралын пайдаланып, curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL сияқты curl POST командасын C кодына түрлендіріңіз. Жасалған код curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string) функциясын пайдаланады. curl2code құралы JSON мазмұны бар -d/--data жалаушаларын автоматты түрде анықтайды және libcurl кодында тиісті Content-Type тақырыбын орнатады.

Q: C тілінде Bearer токенімен авторизацияны қалай қосуға болады?

curl2code құралына curl -H "Authorization: Bearer YOUR_TOKEN" URL командасын беріңіз, ол келесі авторизация тақырыбы бар libcurl кодын жасайды: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code құралы Bearer токендерін -H "Authorization: Bearer ..." және --oauth2-bearer жалаушаларынан анықтайды. Basic auth үшін -u user:pass пайдаланыңыз.

curl2code curl командаларын libcurl пайдаланып, C кодына түрлендіреді. Толық құпиялылық үшін түрлендіру браузеріңізде WebAssembly арқылы орындалады. Rust үшін біздің curl-ді Rust-қа түрлендіргішімізді қараңыз. Go үшін curl-ді Go-ға қараңыз. Төменде жадты дұрыс басқарумен берілген практикалық C мысалдары берілген.

Браузерден curl-ді қалай көшіруге болады

1
DevTools-ты ашу
Браузердің әзірлеуші құралдарын ашу үшін F12 пернесін немесе Ctrl+Shift+I басыңыз.
2
Network қойындысына өтіңіз
Network қойындысын басып, HTTP сұрауын тудыратын әрекетті орындаңыз.
3
cURL ретінде көшіру
Сұрауды оң жақ түймемен басыңыз → Copy → Copy as cURL. Содан кейін оны жоғарыдағы өріске қойыңыз.

C кодының мысалдары

1Қарапайым GET сұрауы

curl командасы

curl https://api.example.com/users

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/users");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;

  return (int)ret;
}

2JSON денесі бар POST сұрауы

curl командасы

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  struct curl_slist *headers;

  headers = NULL;
  headers = curl_slist_append(headers, "Content-Type: application/json");

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/users");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"name\":\"John\",\"email\":\"john@example.com\"}");
  curl_easy_setopt(hnd, CURLOPT_POSTFIELDSIZE_LARGE, (curl_off_t)42);
  curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_slist_free_all(headers);
  headers = NULL;

  return (int)ret;
}

3Bearer токені бар сұрау

curl командасы

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  struct curl_slist *headers;

  headers = NULL;
  headers = curl_slist_append(headers, "Authorization: Bearer token123");

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/me");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_slist_free_all(headers);
  headers = NULL;

  return (int)ret;
}

4Multipart формасын жүктеу

curl командасы

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  curl_mime *mime1;
  curl_mimepart *part1;

  mime1 = NULL;

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/upload");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  mime1 = curl_mime_init(hnd);
  part1 = curl_mime_addpart(mime1);
  curl_mime_filedata(part1, "document.pdf");
  curl_mime_name(part1, "file");
  part1 = curl_mime_addpart(mime1);
  curl_mime_data(part1, "My file", CURL_ZERO_TERMINATED);
  curl_mime_name(part1, "description");
  curl_easy_setopt(hnd, CURLOPT_MIMEPOST, mime1);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_mime_free(mime1);
  mime1 = NULL;

  return (int)ret;
}

5Реттелетін тақырыптар

curl командасы

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  struct curl_slist *headers;

  headers = NULL;
  headers = curl_slist_append(headers, "X-API-Key: abc123");
  headers = curl_slist_append(headers, "Accept: application/json");
  headers = curl_slist_append(headers, "X-Request-ID: req-456");

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/data");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_slist_free_all(headers);
  headers = NULL;

  return (int)ret;
}

Жиі қойылатын сұрақтар

libcurl дегеніміз не?

libcurl — бұл curl командалық жол құралының негізінде жатқан C кітапханасы. Бұл 25-тен астам хаттаманы қолдайтын, әлемдегі ең портативті және кеңінен таралған HTTP клиенттік кітапханасы. Мыңдаған қолданбалар мен ендірілген жүйелерде қолданылады. Жүйелік пакет менеджері арқылы қосыңыз немесе статикалық түрде байланыстырыңыз. curl2code жеңіл интерфейсті қолдана отырып libcurl C кодын жасайды.

libcurl easy vs multi интерфейсі — қайсысын қолданған жөн?

Easy интерфейсі (curl_easy_*) бір синхронды тасымалдауға арналған — қарапайым және түсінікті. Multi интерфейсі (curl_multi_*) бір ағында блоктамайтын конкурентті тасымалдауға мүмкіндік береді. Скрипттер мен қарапайым құралдар үшін easy, жоғары өнімді қолданбалар үшін multi қолданыңыз. Жоғары деңгейлі C-тұқымдас тіл үшін curl-ден Rust-қа қараңыз.

libcurl-мен аутентификацияны қалай өңдеуге болады?

Bearer үшін: curl_slist_append(headers, "Authorization: Bearer token") арқылы реттелетін тақырып орнатыңыз. Basic auth үшін: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl Basic auth деректерін автоматты түрде кодтайды. curl2code -u және тақырып жалаушаларын дұрыс C API шақыруларына түрлендіреді.

libcurl-мен multipart форма деректерін қалай жіберуге болады?

MIME API (libcurl 7.56+) қолданыңыз: mime құрылымын жасау үшін curl_mime_init(), әр өріс үшін curl_mime_addpart(), файлдарды жүктеу үшін curl_mime_name() және curl_mime_filedata(). CURLOPT_MIMEPOST арқылы орнатыңыз. curl_mime_free() арқылы босатыңыз.

libcurl-мен қателерді қалай өңдеуге болады?

Әрбір curl_easy_* функциясы CURLcode қайтарады — оны CURLE_OK-мен салыстырып тексеріңіз. Адам оқи алатын хабарламалар үшін curl_easy_strerror(code) қолданыңыз. Толық қате жолдары үшін CURLOPT_ERRORBUFFER орнатыңыз. HTTP күйін curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code) арқылы алыңыз.

libcurl-мен жадты қалай басқаруға болады?

Тұтқамен (handle) жұмыс аяқталғанда әрқашан curl_easy_cleanup() шақырыңыз. Тақырыптар тізімін curl_slist_free_all() арқылы босатыңыз. MIME құрылымдарын curl_mime_free() арқылы босатыңыз. Жазу кері байланыстары (write callbacks) үшін жеке буфер бөлуді басқарыңыз. Бағдарлама аяқталғанда бір рет curl_global_cleanup() шақырыңыз. Ресурстарды босатпау жадтың ағып кетуіне әкеледі.

libcurl-мен күту уақытын қалай орнатуға болады?

Қосылу күту уақыты үшін CURLOPT_CONNECTTIMEOUT және жалпы тасымалдау уақыты үшін CURLOPT_TIMEOUT орнатыңыз (екеуі де секундпен). Миллисекундтық дәлдік үшін CURLOPT_CONNECTTIMEOUT_MS және CURLOPT_TIMEOUT_MS қолданыңыз. Бұл curl CLI-дегі --connect-timeout және --max-time опцияларымен бірдей.

libcurl-мен проксиді қалай баптауға болады?

CURLOPT_PROXY мәнін прокси URL-іне орнатыңыз: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). SOCKS5 үшін: CURLOPT_PROXYTYPE мәнін CURLPROXY_SOCKS5 етіп орнатыңыз. Прокси аутентификациясы үшін: CURLOPT_PROXYUSERPWD. libcurl сонымен қатар http_proxy орта айнымалысын ескереді.

C тілінде JSON денесі бар POST сұрауын қалай жіберуге болады?

curl2code құралын пайдаланып, curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL сияқты curl POST командасын C кодына түрлендіріңіз. Жасалған код curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string) функциясын пайдаланады. curl2code құралы JSON мазмұны бар -d/--data жалаушаларын автоматты түрде анықтайды және libcurl кодында тиісті Content-Type тақырыбын орнатады.

C тілінде Bearer токенімен авторизацияны қалай қосуға болады?

curl2code құралына curl -H "Authorization: Bearer YOUR_TOKEN" URL командасын беріңіз, ол келесі авторизация тақырыбы бар libcurl кодын жасайды: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code құралы Bearer токендерін -H "Authorization: Bearer ..." және --oauth2-bearer жалаушаларынан анықтайды. Basic auth үшін -u user:pass пайдаланыңыз.

C тілінде Content-Type тақырыбын қалай орнатуға болады?

curl2code құралы curl -H "Content-Type: application/json" URL командасын тиісті тақырыбы бар libcurl кодына түрлендіреді: curl_slist_append(headers, "Content-Type: application/json"). -d деректері үшін curl әдепкі бойынша application/x-www-form-urlencoded мәнін пайдаланады; -F форма жүктеулері үшін ол multipart/form-data мәнін қолданады. curl2code әрқайсысын дұрыс libcurl API интерфейсіне сәйкестендіреді.

Пайдалы сілтемелер

libcurl құжаттамасы

curl.se

Стандартты кітапхана анықтамалығы

curl.se

curl нұсқаулығы (Man Page)

curl.se

curl нұсқаулықтары

curl қате кодтары

Кез келген curl шығу кодын іздеңіз — себептері, түзетулері және жөндеу кеңестері.

curl арқылы файлдарды жүктеу

Файлдарды -o, -O арқылы сақтаңыз, қайта бағыттауларды орындаңыз, жүктеуді жалғастырыңыз және тағы басқа.

SSL, TLS және прокси

Сертификаттарды, TLS нұсқаларын, HTTP/SOCKS проксилерін және реттелетін DNS-ті конфигурациялау.

Браузерден curl-ді қалай көшіруге болады

C кодының мысалдары

1Қарапайым GET сұрауы

2JSON денесі бар POST сұрауы

3Bearer токені бар сұрау

4Multipart формасын жүктеу

5Реттелетін тақырыптар

Жиі қойылатын сұрақтар

Пайдалы сілтемелер

curl нұсқаулықтары

curl-ді басқа тілдерге түрлендіру

C кодының мысалдары

1Қарапайым GET сұрауы

2JSON денесі бар POST сұрауы

3Bearer токені бар сұрау

4Multipart формасын жүктеу

5Реттелетін тақырыптар