Convertește curl în C

Q: Ce este libcurl?

libcurl este biblioteca C din spatele instrumentului în linie de comandă curl. Este cea mai portabilă și mai utilizată bibliotecă de client HTTP existentă, suportând peste 25 de protocoale. Este utilizată de mii de aplicații și sisteme integrate. Adăugați-o cu managerul de pachete al sistemului sau linkați-o static. curl2code generează cod C libcurl folosind interfața easy.

Q: libcurl easy vs multi interface — pe care să o folosesc?

Interfața easy (curl_easy_*) este pentru transferuri sincrone unice — simplă și directă. Interfața multi (curl_multi_*) permite transferuri concurente non-blocante într-un singur thread. Folosiți easy pentru scripturi și instrumente simple, multi pentru aplicații de înaltă performanță. Pentru un limbaj din familia C de nivel superior, consultați curl to Rust.

Q: Cum se gestionează autentificarea cu libcurl?

Pentru Bearer: setați un header personalizat cu curl_slist_append(headers, "Authorization: Bearer token"). Pentru autentificarea Basic: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl codează automat credențialele Basic auth. curl2code convertește flag-urile -u și headerele în apelurile corecte ale API-ului C.

Q: Cum se trimit date de tip multipart form cu libcurl?

Folosiți API-ul MIME (libcurl 7.56+): curl_mime_init() pentru a crea o structură mime, curl_mime_addpart() pentru fiecare câmp, curl_mime_name() și curl_mime_filedata() pentru încărcări de fișiere. Setați cu CURLOPT_MIMEPOST. Eliberați cu curl_mime_free().

Q: Cum se gestionează erorile cu libcurl?

Fiecare funcție curl_easy_* returnează un CURLcode — verificați-l față de CURLE_OK. Folosiți curl_easy_strerror(code) pentru mesaje lizibile de către om. Setați CURLOPT_ERRORBUFFER pentru șiruri de eroare detaliate. Obțineți statusul HTTP cu curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code).

Q: Cum se gestionează memoria cu libcurl?

Apelați întotdeauna curl_easy_cleanup() când ați terminat cu un handle. Eliberați listele de headere cu curl_slist_free_all(). Eliberați structurile MIME cu curl_mime_free(). Pentru callback-urile de scriere, gestionați propria alocare a bufferului. Apelați curl_global_cleanup() o singură dată la ieșirea din program. Ne-eliberarea resurselor cauzează scurgeri de memorie.

Q: Cum se setează timeout-urile cu libcurl?

Setați CURLOPT_CONNECTTIMEOUT pentru timeout-ul conexiunii și CURLOPT_TIMEOUT pentru timpul total de transfer (ambele în secunde). Pentru precizie la nivel de milisecunde, folosiți CURLOPT_CONNECTTIMEOUT_MS și CURLOPT_TIMEOUT_MS. Acestea sunt exact aceleași opțiuni pe care curl CLI le folosește cu --connect-timeout și --max-time.

Q: Cum se configurează un proxy cu libcurl?

Setați CURLOPT_PROXY la URL-ul proxy-ului: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). Pentru SOCKS5: setați CURLOPT_PROXYTYPE la CURLPROXY_SOCKS5. Pentru autentificare proxy: CURLOPT_PROXYUSERPWD. libcurl respectă, de asemenea, variabila de mediu http_proxy.

Q: Cum se trimite o cerere POST cu un corp JSON în C?

Convertește o comandă curl POST precum curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL în C folosind curl2code. Codul generat utilizează curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code detectează automat flag-urile -d/--data cu conținut JSON și setează antetul Content-Type corespunzător în codul libcurl.

Q: Cum se adaugă autorizarea prin Bearer token în C?

Introdu curl -H "Authorization: Bearer YOUR_TOKEN" URL în curl2code și acesta va genera cod libcurl cu antetul de autentificare: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code detectează Bearer tokens atât din flag-urile -H "Authorization: Bearer ...", cât și din --oauth2-bearer. Pentru Basic auth, utilizează -u user:pass.

curl2code convertește comenzile curl în cod C folosind libcurl. Conversia rulează în browserul tău prin WebAssembly pentru confidențialitate deplină. Pentru Rust, verifică convertorul nostru curl în Rust. Pentru Go, vezi curl în Go. Mai jos sunt exemple practice C cu gestionare corectă a memoriei.

Cum să copiezi curl din browserul tău

1
Deschide DevTools
Apasă F12 sau Ctrl+Shift+I pentru a deschide instrumentele de dezvoltare ale browserului.
2
Mergi la fila Network
Fă clic pe fila Network și efectuează acțiunea care declanșează cererea HTTP.
3
Copiază ca cURL
Fă clic dreapta pe cerere → Copy → Copy as cURL. Apoi lipește-o mai sus.

Exemple de cod C

1Cerere GET simplă

comandă 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;
}

2POST cu corp JSON

comandă 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;
}

3Cerere cu Bearer Token

comandă 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;
}

4Încărcare formular multipart

comandă 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;
}

5Antete personalizate

comandă 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;
}

Întrebări frecvente

Ce este libcurl?

libcurl este biblioteca C din spatele instrumentului în linie de comandă curl. Este cea mai portabilă și mai utilizată bibliotecă de client HTTP existentă, suportând peste 25 de protocoale. Este utilizată de mii de aplicații și sisteme integrate. Adăugați-o cu managerul de pachete al sistemului sau linkați-o static. curl2code generează cod C libcurl folosind interfața easy.

libcurl easy vs multi interface — pe care să o folosesc?

Interfața easy (curl_easy_*) este pentru transferuri sincrone unice — simplă și directă. Interfața multi (curl_multi_*) permite transferuri concurente non-blocante într-un singur thread. Folosiți easy pentru scripturi și instrumente simple, multi pentru aplicații de înaltă performanță. Pentru un limbaj din familia C de nivel superior, consultați curl to Rust.

Cum se gestionează autentificarea cu libcurl?

Pentru Bearer: setați un header personalizat cu curl_slist_append(headers, "Authorization: Bearer token"). Pentru autentificarea Basic: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl codează automat credențialele Basic auth. curl2code convertește flag-urile -u și headerele în apelurile corecte ale API-ului C.

Cum se trimit date de tip multipart form cu libcurl?

Folosiți API-ul MIME (libcurl 7.56+): curl_mime_init() pentru a crea o structură mime, curl_mime_addpart() pentru fiecare câmp, curl_mime_name() și curl_mime_filedata() pentru încărcări de fișiere. Setați cu CURLOPT_MIMEPOST. Eliberați cu curl_mime_free().

Cum se gestionează erorile cu libcurl?

Fiecare funcție curl_easy_* returnează un CURLcode — verificați-l față de CURLE_OK. Folosiți curl_easy_strerror(code) pentru mesaje lizibile de către om. Setați CURLOPT_ERRORBUFFER pentru șiruri de eroare detaliate. Obțineți statusul HTTP cu curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code).

Cum se gestionează memoria cu libcurl?

Apelați întotdeauna curl_easy_cleanup() când ați terminat cu un handle. Eliberați listele de headere cu curl_slist_free_all(). Eliberați structurile MIME cu curl_mime_free(). Pentru callback-urile de scriere, gestionați propria alocare a bufferului. Apelați curl_global_cleanup() o singură dată la ieșirea din program. Ne-eliberarea resurselor cauzează scurgeri de memorie.

Cum se setează timeout-urile cu libcurl?

Setați CURLOPT_CONNECTTIMEOUT pentru timeout-ul conexiunii și CURLOPT_TIMEOUT pentru timpul total de transfer (ambele în secunde). Pentru precizie la nivel de milisecunde, folosiți CURLOPT_CONNECTTIMEOUT_MS și CURLOPT_TIMEOUT_MS. Acestea sunt exact aceleași opțiuni pe care curl CLI le folosește cu --connect-timeout și --max-time.

Cum se configurează un proxy cu libcurl?

Setați CURLOPT_PROXY la URL-ul proxy-ului: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). Pentru SOCKS5: setați CURLOPT_PROXYTYPE la CURLPROXY_SOCKS5. Pentru autentificare proxy: CURLOPT_PROXYUSERPWD. libcurl respectă, de asemenea, variabila de mediu http_proxy.

Cum se trimite o cerere POST cu un corp JSON în C?

Convertește o comandă curl POST precum curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL în C folosind curl2code. Codul generat utilizează curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code detectează automat flag-urile -d/--data cu conținut JSON și setează antetul Content-Type corespunzător în codul libcurl.

Cum se adaugă autorizarea prin Bearer token în C?

Introdu curl -H "Authorization: Bearer YOUR_TOKEN" URL în curl2code și acesta va genera cod libcurl cu antetul de autentificare: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code detectează Bearer tokens atât din flag-urile -H "Authorization: Bearer ...", cât și din --oauth2-bearer. Pentru Basic auth, utilizează -u user:pass.

Cum se setează antetul Content-Type în C?

curl2code convertește curl -H "Content-Type: application/json" URL în cod libcurl cu antetul corect: curl_slist_append(headers, "Content-Type: application/json"). Pentru datele -d, curl folosește implicit application/x-www-form-urlencoded; pentru încărcările de formulare -F, folosește multipart/form-data. curl2code mapează fiecare opțiune către API-ul libcurl corect.

Linkuri utile

Documentație libcurl

curl.se

Referință bibliotecă standard

curl.se

Pagina manual curl

curl.se

Ghiduri curl

Coduri de eroare curl

Caută orice cod de ieșire curl — cauze, rezolvări și sfaturi de depanare.

Descărcarea fișierelor cu curl

Salvează fișiere cu -o, -O, urmează redirecționări, reia descărcări și multe altele.

SSL, TLS și proxy

Configurează certificate, versiuni TLS, proxy-uri HTTP/SOCKS și DNS personalizat.

Cum să copiezi curl din browserul tău

Exemple de cod C

1Cerere GET simplă

2POST cu corp JSON

3Cerere cu Bearer Token

4Încărcare formular multipart

5Antete personalizate

Întrebări frecvente

Linkuri utile

Ghiduri curl

Convertește curl în alte limbaje

Exemple de cod C

1Cerere GET simplă

2POST cu corp JSON

3Cerere cu Bearer Token

4Încărcare formular multipart

5Antete personalizate