המרת curl ל-C

Q: מהו libcurl?

libcurl היא ספריית ה-C שמאחורי כלי השורה curl. זוהי ספריית לקוח ה-HTTP הניידת והנפוצה ביותר שקיימת, התומכת ב-25+ פרוטוקולים. בשימוש על ידי אלפי אפליקציות ומערכות משובצות (embedded). הוסיפו עם מנהל החבילות של המערכת או קשרו סטטית. curl2code מייצר קוד libcurl C באמצעות ממשק ה-easy.

Q: ממשק libcurl easy לעומת multi — במה להשתמש?

ממשק ה-easy (curl_easy_*) מיועד להעברות סינכרוניות בודדות — פשוט וישיר. ממשק ה-multi (curl_multi_*) מאפשר העברות מקביליות לא-חוסמות ב-thread בודד. השתמשו ב-easy עבור סקריפטים וכלים פשוטים, וב-multi עבור אפליקציות בעלות ביצועים גבוהים. לשפת משפחת C ברמה גבוהה יותר, ראו curl ל-Rust.

Q: איך מטפלים באימות עם libcurl?

עבור Bearer: הגדירו כותרת מותאמת אישית עם curl_slist_append(headers, "Authorization: Bearer token"). עבור אימות Basic: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl מקודד אוטומטית אישורי אימות Basic. curl2code ממיר דגלי -u וכותרות לקריאות ה-API הנכונות ב-C.

Q: איך שולחים נתוני multipart form עם libcurl?

השתמשו ב-API של MIME (libcurl 7.56+): curl_mime_init() ליצירת מבנה mime, curl_mime_addpart() לכל שדה, curl_mime_name() ו-curl_mime_filedata() להעלאת קבצים. הגדירו עם CURLOPT_MIMEPOST. שחררו עם curl_mime_free().

Q: איך מטפלים בשגיאות עם libcurl?

כל פונקציית curl_easy_* מחזירה CURLcode — בדקו מול CURLE_OK. השתמשו ב-curl_easy_strerror(code) להודעות קריאות לבני אדם. הגדירו CURLOPT_ERRORBUFFER למחרוזות שגיאה מפורטות. קבלו את סטטוס ה-HTTP עם curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code).

Q: איך מנהלים זיכרון עם libcurl?

קראו תמיד ל-curl_easy_cleanup() בסיום השימוש ב-handle. שחררו רשימות כותרות עם 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: איך מגדירים proxy עם libcurl?

הגדירו את CURLOPT_PROXY לכתובת ה-proxy: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). עבור SOCKS5: הגדירו את CURLOPT_PROXYTYPE ל-CURLPROXY_SOCKS5. עבור אימות פרוקסי: CURLOPT_PROXYUSERPWD. libcurl מכבד גם את משתנה הסביבה http_proxy.

Q: איך שולחים בקשת POST עם גוף JSON ב-C?

המירו פקודת curl POST כמו curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL ל-C באמצעות curl2code. הקוד שנוצר משתמש ב-curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code מזהה באופן אוטומטי דגלי -d/--data עם תוכן JSON ומגדיר את כותרת Content-Type המתאימה בקוד ה-libcurl.

Q: איך מוסיפים אימות Bearer token ב-C?

העבירו את curl -H "Authorization: Bearer YOUR_TOKEN" URL ל-curl2code והוא יפיק קוד libcurl עם כותרת האימות: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code מזהה Bearer tokens גם מדגלי -H "Authorization: Bearer ..." וגם מדגלי --oauth2-bearer. עבור Basic auth, השתמשו ב--u user:pass.

curl2code ממיר פקודות curl לקוד C באמצעות libcurl. ההמרה מתבצעת בדפדפן שלך דרך 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;
}

2POST עם גוף JSON

פקודת 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בקשה עם Bearer Token

פקודת 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העלאת טופס Multipart

פקודת 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כותרות (Headers) מותאמות אישית

פקודת 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;
}

שאלות נפוצות (FAQ)

מהו libcurl?

libcurl היא ספריית ה-C שמאחורי כלי השורה curl. זוהי ספריית לקוח ה-HTTP הניידת והנפוצה ביותר שקיימת, התומכת ב-25+ פרוטוקולים. בשימוש על ידי אלפי אפליקציות ומערכות משובצות (embedded). הוסיפו עם מנהל החבילות של המערכת או קשרו סטטית. curl2code מייצר קוד libcurl C באמצעות ממשק ה-easy.

ממשק libcurl easy לעומת multi — במה להשתמש?

ממשק ה-easy (curl_easy_*) מיועד להעברות סינכרוניות בודדות — פשוט וישיר. ממשק ה-multi (curl_multi_*) מאפשר העברות מקביליות לא-חוסמות ב-thread בודד. השתמשו ב-easy עבור סקריפטים וכלים פשוטים, וב-multi עבור אפליקציות בעלות ביצועים גבוהים. לשפת משפחת C ברמה גבוהה יותר, ראו curl ל-Rust.

איך מטפלים באימות עם libcurl?

עבור Bearer: הגדירו כותרת מותאמת אישית עם curl_slist_append(headers, "Authorization: Bearer token"). עבור אימות Basic: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl מקודד אוטומטית אישורי אימות Basic. curl2code ממיר דגלי -u וכותרות לקריאות ה-API הנכונות ב-C.

איך שולחים נתוני multipart form עם libcurl?

השתמשו ב-API של MIME (libcurl 7.56+): curl_mime_init() ליצירת מבנה mime, 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?

קראו תמיד ל-curl_easy_cleanup() בסיום השימוש ב-handle. שחררו רשימות כותרות עם 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.

איך מגדירים proxy עם libcurl?

הגדירו את CURLOPT_PROXY לכתובת ה-proxy: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). עבור SOCKS5: הגדירו את CURLOPT_PROXYTYPE ל-CURLPROXY_SOCKS5. עבור אימות פרוקסי: CURLOPT_PROXYUSERPWD. libcurl מכבד גם את משתנה הסביבה http_proxy.

איך שולחים בקשת POST עם גוף JSON ב-C?

המירו פקודת curl POST כמו curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL ל-C באמצעות curl2code. הקוד שנוצר משתמש ב-curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code מזהה באופן אוטומטי דגלי -d/--data עם תוכן JSON ומגדיר את כותרת Content-Type המתאימה בקוד ה-libcurl.

איך מוסיפים אימות Bearer token ב-C?

העבירו את curl -H "Authorization: Bearer YOUR_TOKEN" URL ל-curl2code והוא יפיק קוד libcurl עם כותרת האימות: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code מזהה Bearer tokens גם מדגלי -H "Authorization: Bearer ..." וגם מדגלי --oauth2-bearer. עבור Basic auth, השתמשו ב--u user:pass.

איך מגדירים כותרת Content-Type ב-C?

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 ממפה כל אחד מהם ל-API הנכון של libcurl.

קישורים שימושיים

תיעוד libcurl

curl.se

תיעוד הספרייה הסטנדרטית

curl.se

דף ה-Man של curl

curl.se

מדריכי curl

קודי שגיאה של curl

חפשו כל קוד יציאה של curl — סיבות, תיקונים וטיפים לניפוי שגיאות.

הורדת קבצים עם curl

שמרו קבצים עם -o, -O, עקבו אחר הפניות, חדשו הורדות ועוד.

SSL, TLS ופרוקסי

הגדירו תעודות, גרסאות TLS, פרוקסי HTTP/SOCKS ו-DNS מותאם אישית.

איך להעתיק curl מהדפדפן שלך

דוגמאות קוד ב-C

1בקשת GET פשוטה

2POST עם גוף JSON

3בקשה עם Bearer Token

4העלאת טופס Multipart

5כותרות (Headers) מותאמות אישית

שאלות נפוצות (FAQ)

קישורים שימושיים

מדריכי curl

המרת curl לשפות אחרות

דוגמאות קוד ב-C

1בקשת GET פשוטה

2POST עם גוף JSON

3בקשה עם Bearer Token

4העלאת טופס Multipart

5כותרות (Headers) מותאמות אישית