كيفية استخدام cURL على نظام التشغيل Windows 10: الأوامر الأساسية

يتضمن نظام التشغيل Windows 10 أداة curl.exe ، مما يتيح لك إرسال طلبات الويب من خلال PowerShell أو موجه الأوامر دون الحاجة إلى تثبيت أداة منفصلة. افتح نافذة طرفية، وتأكد من تشغيلها، ثم استخدم cURL مع عنوان URL لاسترداد صفحة، أو فحص رؤوس الاستجابة، أو تنزيل ملف، أو إرسال بيانات إلى واجهة برمجة تطبيقات (API). في Windows PowerShell 5.1، اكتب الأمر التالي curl.exeبدلاً من curlالأمر السابق، حتى يقوم PowerShell بتشغيل برنامج cURL الفعلي.

1. افتح نافذة طرفية وتحقق من cURL

افتح قائمة ابدأ، وابحث عن PowerShell أو موجه الأوامر ، ثم قم بتشغيله كالمعتاد. لا تتطلب الطلبات العادية أو التنزيلات إلى مجلدات المستخدم الخاصة بك صلاحيات المسؤول.

curl.exe --version

تتضمن المخرجات الإصدار المُثبّت والبروتوكولات والميزات المتوفرة في هذا الإصدار. يحتوي Windows PowerShell 5.1 على اسم مستعار مُدمج للأمر curlالمُنفصل Invoke-WebRequest، لذا قد تتصرف الأوامر المنسوخة من دروس Linux بشكل مختلف ما لم تستخدم الأمر ` curl.execURL`. لا يُعرّف PowerShell 7 هذا الاسم المستعار. توثّق Microsoft هذا الاختلاف في دليل cURL على Windows .

2. تقديم طلب أساسي

ضع عنوان URL بعد الأمر. يستخدم cURL طلب HTTP GET افتراضيًا ويكتب نص الاستجابة في الطرفية:

curl.exe "https://example.com"

بالنسبة لصفحة الويب، تكون الاستجابة بتنسيق HTML؛ أما واجهة برمجة التطبيقات (API) فقد تُرجع JSON أو تنسيقًا آخر. ينقل الأمر الاستجابة كما هي بدلًا من عرضها كما يفعل المتصفح. إذا كان عنوان URL يحتوي على أحرف مثل &أو ?، فاحتفظ بعنوان URL الكامل بين علامتي اقتباس حتى يمرره النظام كوسيط واحد.

3. تحقق من رؤوس الاستجابة

استخدم الأحرف الكبيرة -Iلإرسال طلب HEAD وعرض رؤوس الاستجابة دون تنزيل محتوى الطلب:

curl.exe -I "https://example.com"

يمكن أن تُظهر الرؤوس حالة HTTP، ونوع المحتوى، وتفاصيل التخزين المؤقت، وبيانات تعريف الخادم الأخرى. بعض الخدمات لا تدعم طلب HEAD أو تُعيد نتيجة مختلفة له عن طلب GET. لإضافة رؤوس إلى استجابة GET عادية، استخدم الأحرف الصغيرة -i. استخدم هذا الخيار -Lعندما يُعيد الخادم توجيه الطلب وتريد من cURL اتباع هذا التوجيه.

4. حفظ الرد في ملف

بشكل افتراضي، يطبع cURL بيانات الاستجابة في الطرفية. استخدم الأمر -oلاختيار اسم الملف وموقعه. يكتب مثال PowerShell هذا استجابة HTML في مجلد التنزيلات لديك:

curl.exe -L -o "$env:USERPROFILE\Downloads\example.html" "https://example.com"

-Lيتبع الأمر عمليات إعادة التوجيه، بينما -oيُسمّي ملف الإخراج. يقوم الأمر باستبدال ملف بنفس الاسم، لذا اختر وجهة بعناية. لحفظ الملف في المجلد الحالي، استخدم الأمر curl.exe -L -o "example.html" "https://example.com". -Oيستخدم الخيار (حرف O كبير) اسم الملف من عنوان URL.

curl.exe -L -O "https://example.com/files/archive.zip"

الرابط الثاني هو مثال على التنسيق؛ استبدله برابط ملف مباشر موجود ومصرح لك بتنزيله.

5. إرسال بيانات JSON إلى واجهة برمجة التطبيقات (API)

لطلب JSON POST، حدد طريقة الطلب ونوع المحتوى ونص الطلب. استبدل نقطة النهاية المذكورة في المثال بعنوان URL الخاص بواجهة برمجة التطبيقات (API) الخاصة بك.

curl.exe -X POST "https://api.example.com/items" -H "Content-Type: application/json" -d '{"name":"widget"}'

-X POSTيُحدد هذا الأمر طريقة HTTP، -Hويُضيف ترويسة، -dويُرسل محتوى الطلب. يجب أن يقبل الخادم طلبات POST، وأن تتطابق حقول JSON مع واجهة برمجة التطبيقات (API) الخاصة به. تجنب لصق كلمات المرور أو الرموز الخاصة أو أي بيانات سرية أخرى في الأمر إذا كان سجل الأوامر أو السجلات المشتركة قد يكشفها. يُفصّل دليل cURL الرسمي هذه الخيارات ومتطلبات إصداراتها.

إصلاح المشاكل الشائعة

• لم يتم التعرف على cURL. شغّله where.exe curlفي PowerShell أو موجه الأوامر. في نظام Windows 10، تتوفر نسخة Microsoft عادةً باسم cURL C:\Windows\System32\curl.exe. إذا كان الملف التنفيذي مفقودًا من تثبيت مُخصّص، فقم بتنزيل إصدار Windows من صفحة cURL الرسمية لنظام Windows ، واختر الحزمة المناسبة لنظامك، وشغّله curl.exeمن المجلد المُستخرج. أضف هذا المجلد إلى متغير PATH فقط إذا كنت ترغب في تشغيله من أي مجلد.
• يُشير PowerShell إلى أن أحد المعاملات غير صالح. تأكد من أن الأمر يبدأ بـ curl.exe. في Windows PowerShell 5.1، curlقد يتم استدعاء الأمر العادي Invoke-WebRequestبدلاً من ذلك.
• فشل الطلب بسبب خطأ في شهادة HTTPS. تحقق من تاريخ ووقت جهاز الكمبيوتر، وقم بتحديث نظام التشغيل Windows، وتأكد مما إذا كان خادم وكيل العمل أو برنامج الأمان يتطلب شهادة موثوقة. تجنب استخدام -kهذا الحل كإجراء روتيني لأنه يعطل التحقق من الشهادة.

لا يزال نظام التشغيل Windows 10 يدعم cURL، لكن مايكروسوفت أنهت دعم Windows 10 في 14 أكتوبر 2025. لم تعد الأجهزة التي لا تخضع لبرنامج تحديثات الأمان المعمول به تتلقى إصلاحات أمنية منتظمة؛ راجع إشعار دعم Windows 10 من مايكروسوفت .