تحويل curl إلى C

Q: ما هي libcurl؟

libcurl هي مكتبة C التي تقف وراء أداة سطر أوامر curl. إنها مكتبة عميل HTTP الأكثر قابلية للنقل والانتشار على الإطلاق، حيث تدعم أكثر من 25 بروتوكولاً. تستخدمها آلاف التطبيقات والأنظمة المدمجة. أضفها باستخدام مدير حزم النظام الخاص بك أو اربطها بشكل ثابت. يقوم curl2code بتوليد كود libcurl C باستخدام الواجهة السهلة (easy interface).

Q: واجهة libcurl easy مقابل multi — أيهما أستخدم؟

الواجهة السهلة easy interface (curl_easy_*) مخصصة لعمليات النقل المتزامنة الفردية — بسيطة ومباشرة. الواجهة المتعددة multi interface (curl_multi_*) تتيح عمليات نقل متزامنة غير حاجزة في خيط واحد (thread). استخدم easy للسكربتات والأدوات البسيطة، و multi للتطبيقات عالية الأداء. للغة من عائلة C ذات مستوى أعلى، راجع curl إلى Rust.

Q: كيفية التعامل مع المصادقة باستخدام libcurl؟

لـ Bearer: اضبط ترويسة مخصصة باستخدام curl_slist_append(headers, "Authorization: Bearer token"). للمصادقة الأساسية: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). تقوم libcurl بترميز بيانات اعتماد المصادقة الأساسية تلقائيًا. يقوم curl2code بتحويل أعلام -u والترويسات إلى استدعاءات C API الصحيحة.

Q: كيفية إرسال بيانات النموذج متعدد الأجزاء باستخدام libcurl؟

استخدم MIME API (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: كيفية تهيئة بروكسي باستخدام libcurl؟

اضبط CURLOPT_PROXY على عنوان URL للبروكسي: 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 من كل من وسوم -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 Form)

أمر 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رؤوس مخصصة (Custom 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;
}

الأسئلة الشائعة

ما هي libcurl؟

libcurl هي مكتبة C التي تقف وراء أداة سطر أوامر curl. إنها مكتبة عميل HTTP الأكثر قابلية للنقل والانتشار على الإطلاق، حيث تدعم أكثر من 25 بروتوكولاً. تستخدمها آلاف التطبيقات والأنظمة المدمجة. أضفها باستخدام مدير حزم النظام الخاص بك أو اربطها بشكل ثابت. يقوم curl2code بتوليد كود libcurl C باستخدام الواجهة السهلة (easy interface).

واجهة libcurl easy مقابل multi — أيهما أستخدم؟

الواجهة السهلة easy interface (curl_easy_*) مخصصة لعمليات النقل المتزامنة الفردية — بسيطة ومباشرة. الواجهة المتعددة multi interface (curl_multi_*) تتيح عمليات نقل متزامنة غير حاجزة في خيط واحد (thread). استخدم easy للسكربتات والأدوات البسيطة، و multi للتطبيقات عالية الأداء. للغة من عائلة C ذات مستوى أعلى، راجع curl إلى Rust.

كيفية التعامل مع المصادقة باستخدام libcurl؟

لـ Bearer: اضبط ترويسة مخصصة باستخدام curl_slist_append(headers, "Authorization: Bearer token"). للمصادقة الأساسية: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). تقوم libcurl بترميز بيانات اعتماد المصادقة الأساسية تلقائيًا. يقوم curl2code بتحويل أعلام -u والترويسات إلى استدعاءات C API الصحيحة.

كيفية إرسال بيانات النموذج متعدد الأجزاء باستخدام libcurl؟

استخدم MIME API (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.

كيفية تهيئة بروكسي باستخدام libcurl؟

اضبط CURLOPT_PROXY على عنوان URL للبروكسي: 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 من كل من وسوم -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

صفحة دليل 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 Form)

5رؤوس مخصصة (Custom Headers)

الأسئلة الشائعة

روابط مفيدة

أدلة curl

تحويل curl إلى لغات أخرى

أمثلة كود C

1طلب GET بسيط

2POST مع جسم JSON

3طلب مع Bearer Token

4رفع نموذج متعدد الأجزاء (Multipart Form)

5رؤوس مخصصة (Custom Headers)