Konwertuj curl na C

Q: Czym jest libcurl?

libcurl to biblioteka C stojąca za narzędziem wiersza poleceń curl. Jest to najbardziej przenośna i powszechnie wdrażana biblioteka klienta HTTP, obsługująca ponad 25 protokołów. Używana przez tysiące aplikacji i systemów wbudowanych. Dodaj ją za pomocą menedżera pakietów systemowych lub polinkuj statycznie. curl2code generuje kod C libcurl przy użyciu interfejsu easy.

Q: Interfejs libcurl easy vs multi — którego użyć?

Interfejs easy (curl_easy_*) służy do pojedynczych transferów synchronicznych — jest prosty i bezpośredni. Interfejs multi (curl_multi_*) umożliwia nieblokujące transfery współbieżne w jednym wątku. Używaj easy dla skryptów i prostych narzędzi, a multi dla aplikacji o wysokiej wydajności. Dla języka wyższego poziomu z rodziny C zobacz curl na Rust.

Q: Jak obsługiwać uwierzytelnianie w libcurl?

Dla Bearer: ustaw niestandardowy nagłówek za pomocą curl_slist_append(headers, "Authorization: Bearer token"). Dla uwierzytelniania Basic: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl automatycznie koduje poświadczenia Basic. curl2code konwertuje flagi -u i nagłówki na poprawne wywołania API C.

Q: Jak wysyłać dane formularza multipart w libcurl?

Użyj MIME API (libcurl 7.56+): curl_mime_init() aby utworzyć strukturę mime, curl_mime_addpart() dla każdego pola, curl_mime_name() i curl_mime_filedata() dla przesyłania plików. Ustaw za pomocą CURLOPT_MIMEPOST. Zwolnij pamięć przez curl_mime_free().

Q: Jak obsługiwać błędy w libcurl?

Każda funkcja curl_easy_* zwraca CURLcode — sprawdź go pod kątem CURLE_OK. Użyj curl_easy_strerror(code) dla komunikatów czytelnych dla człowieka. Ustaw CURLOPT_ERRORBUFFER dla szczegółowych opisów błędów. Pobierz status HTTP za pomocą curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code).

Q: Jak zarządzać pamięcią w libcurl?

Zawsze wywołuj curl_easy_cleanup() po zakończeniu pracy z uchwytem. Zwalniaj listy nagłówków przez curl_slist_free_all(). Zwalniaj struktury MIME przez curl_mime_free(). W przypadku callbacków zapisu, samodzielnie zarządzaj alokacją bufora. Wywołaj curl_global_cleanup() raz przy wyjściu z programu. Brak zwalniania zasobów powoduje wycieki pamięci.

Q: Jak ustawić limity czasu w libcurl?

Ustaw CURLOPT_CONNECTTIMEOUT dla limitu czasu połączenia i CURLOPT_TIMEOUT dla całkowitego czasu transferu (oba w sekundach). Dla precyzji milisekundowej użyj CURLOPT_CONNECTTIMEOUT_MS i CURLOPT_TIMEOUT_MS. Są to te same opcje, których używa CLI curl z --connect-timeout i --max-time.

Q: Jak skonfigurować proxy w libcurl?

Ustaw CURLOPT_PROXY na URL proxy: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). Dla SOCKS5: ustaw CURLOPT_PROXYTYPE na CURLPROXY_SOCKS5. Dla uwierzytelniania proxy: CURLOPT_PROXYUSERPWD. libcurl respektuje również zmienną środowiskową http_proxy.

Q: Jak wysłać żądanie POST z ciałem JSON w języku C?

Konwertuj polecenie curl POST, takie jak curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL na kod C za pomocą curl2code. Wygenerowany kod używa curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code automatycznie wykrywa flagi -d/--data z zawartością JSON i ustawia odpowiedni nagłówek Content-Type w kodzie libcurl.

Q: Jak dodać autoryzację Bearer token w języku C?

Przekaż curl -H "Authorization: Bearer YOUR_TOKEN" URL do curl2code, a narzędzie wygeneruje kod libcurl z nagłówkiem autoryzacji: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code wykrywa tokeny Bearer zarówno z flag -H "Authorization: Bearer ...", jak i --oauth2-bearer. W przypadku Basic auth użyj -u user:pass.

curl2code konwertuje polecenia curl na kod C przy użyciu libcurl. Konwersja odbywa się w przeglądarce poprzez WebAssembly, zapewniając pełną prywatność. W przypadku Rust, sprawdź nasz konwerter curl na Rust. W przypadku Go, zobacz curl na Go. Poniżej znajdują się praktyczne przykłady w C z poprawnym zarządzaniem pamięcią.

Jak skopiować polecenie curl z przeglądarki

1
Otwórz DevTools
Naciśnij F12 lub Ctrl+Shift+I, aby otworzyć narzędzia programistyczne przeglądarki.
2
Przejdź do karty Sieć
Kliknij kartę Sieć i wykonaj akcję, która wywołuje żądanie HTTP.
3
Kopiuj jako cURL
Kliknij żądanie prawym przyciskiem myszy → Kopiuj → Kopiuj jako cURL. Następnie wklej je powyżej.

Przykłady kodu w C

1Proste żądanie GET

polecenie 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 z treścią JSON

polecenie 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;
}

3Żądanie z tokenem Bearer

polecenie 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;
}

4Przesyłanie formularza Multipart

polecenie 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;
}

5Niestandardowe nagłówki

polecenie 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;
}

Najczęściej zadawane pytania

Czym jest libcurl?

libcurl to biblioteka C stojąca za narzędziem wiersza poleceń curl. Jest to najbardziej przenośna i powszechnie wdrażana biblioteka klienta HTTP, obsługująca ponad 25 protokołów. Używana przez tysiące aplikacji i systemów wbudowanych. Dodaj ją za pomocą menedżera pakietów systemowych lub polinkuj statycznie. curl2code generuje kod C libcurl przy użyciu interfejsu easy.

Interfejs libcurl easy vs multi — którego użyć?

Interfejs easy (curl_easy_*) służy do pojedynczych transferów synchronicznych — jest prosty i bezpośredni. Interfejs multi (curl_multi_*) umożliwia nieblokujące transfery współbieżne w jednym wątku. Używaj easy dla skryptów i prostych narzędzi, a multi dla aplikacji o wysokiej wydajności. Dla języka wyższego poziomu z rodziny C zobacz curl na Rust.

Jak obsługiwać uwierzytelnianie w libcurl?

Dla Bearer: ustaw niestandardowy nagłówek za pomocą curl_slist_append(headers, "Authorization: Bearer token"). Dla uwierzytelniania Basic: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl automatycznie koduje poświadczenia Basic. curl2code konwertuje flagi -u i nagłówki na poprawne wywołania API C.

Jak wysyłać dane formularza multipart w libcurl?

Użyj MIME API (libcurl 7.56+): curl_mime_init() aby utworzyć strukturę mime, curl_mime_addpart() dla każdego pola, curl_mime_name() i curl_mime_filedata() dla przesyłania plików. Ustaw za pomocą CURLOPT_MIMEPOST. Zwolnij pamięć przez curl_mime_free().

Jak obsługiwać błędy w libcurl?

Każda funkcja curl_easy_* zwraca CURLcode — sprawdź go pod kątem CURLE_OK. Użyj curl_easy_strerror(code) dla komunikatów czytelnych dla człowieka. Ustaw CURLOPT_ERRORBUFFER dla szczegółowych opisów błędów. Pobierz status HTTP za pomocą curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code).

Jak zarządzać pamięcią w libcurl?

Zawsze wywołuj curl_easy_cleanup() po zakończeniu pracy z uchwytem. Zwalniaj listy nagłówków przez curl_slist_free_all(). Zwalniaj struktury MIME przez curl_mime_free(). W przypadku callbacków zapisu, samodzielnie zarządzaj alokacją bufora. Wywołaj curl_global_cleanup() raz przy wyjściu z programu. Brak zwalniania zasobów powoduje wycieki pamięci.

Jak ustawić limity czasu w libcurl?

Ustaw CURLOPT_CONNECTTIMEOUT dla limitu czasu połączenia i CURLOPT_TIMEOUT dla całkowitego czasu transferu (oba w sekundach). Dla precyzji milisekundowej użyj CURLOPT_CONNECTTIMEOUT_MS i CURLOPT_TIMEOUT_MS. Są to te same opcje, których używa CLI curl z --connect-timeout i --max-time.

Jak skonfigurować proxy w libcurl?

Ustaw CURLOPT_PROXY na URL proxy: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). Dla SOCKS5: ustaw CURLOPT_PROXYTYPE na CURLPROXY_SOCKS5. Dla uwierzytelniania proxy: CURLOPT_PROXYUSERPWD. libcurl respektuje również zmienną środowiskową http_proxy.

Jak wysłać żądanie POST z ciałem JSON w języku C?

Konwertuj polecenie curl POST, takie jak curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL na kod C za pomocą curl2code. Wygenerowany kod używa curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code automatycznie wykrywa flagi -d/--data z zawartością JSON i ustawia odpowiedni nagłówek Content-Type w kodzie libcurl.

Jak dodać autoryzację Bearer token w języku C?

Przekaż curl -H "Authorization: Bearer YOUR_TOKEN" URL do curl2code, a narzędzie wygeneruje kod libcurl z nagłówkiem autoryzacji: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code wykrywa tokeny Bearer zarówno z flag -H "Authorization: Bearer ...", jak i --oauth2-bearer. W przypadku Basic auth użyj -u user:pass.

Jak ustawić nagłówek Content-Type w języku C?

curl2code konwertuje curl -H "Content-Type: application/json" URL na kod libcurl z właściwym nagłówkiem: curl_slist_append(headers, "Content-Type: application/json"). Dla danych -d curl domyślnie ustawia application/x-www-form-urlencoded; dla przesyłania formularzy -F używa multipart/form-data. curl2code mapuje każde z nich na odpowiednie API libcurl.

Przydatne linki

Dokumentacja libcurl

curl.se

Dokumentacja biblioteki standardowej

curl.se

Strona podręcznika (man) curl

curl.se

Poradniki curl

Kody błędów curl

Sprawdź dowolny kod wyjścia curl — przyczyny, rozwiązania i wskazówki debugowania.

Pobieranie plików za pomocą curl

Zapisuj pliki z -o, -O, podążaj za przekierowaniami, wznawiaj pobieranie i więcej.

SSL, TLS i proxy

Konfiguracja certyfikatów, wersji TLS, proxy HTTP/SOCKS i niestandardowego DNS.

Jak skopiować polecenie curl z przeglądarki

Przykłady kodu w C

1Proste żądanie GET

2POST z treścią JSON

3Żądanie z tokenem Bearer

4Przesyłanie formularza Multipart

5Niestandardowe nagłówki

Najczęściej zadawane pytania

Przydatne linki

Poradniki curl

Konwertuj curl na inne języki

Przykłady kodu w C

1Proste żądanie GET

2POST z treścią JSON

3Żądanie z tokenem Bearer

4Przesyłanie formularza Multipart

5Niestandardowe nagłówki