.
cURL وثائق الاستخدام
cURL هو أداة سطر أوامر ومكتبة تستخدم لنقل البيانات. يدعم العديد من البروتوكولات، بما في ذلك HTTP و HTTPS و FTP وما إلى ذلك. cURL مفيد للغاية في تطوير الويب، وخاصة في إجراء طلبات HTTP، وتنزيل الملفات، واستدعاءات API. يأتي ServBay مثبتاً مسبقاً مع cURL، وستشرح هذه المقالة كيفية تثبيت وتكوين واستخدام cURL بالتفصيل.
الفهرس
التثبيت والتكوين
التثبيت
يأتي ServBay مثبتاً مسبقاً مع cURL، ولا يحتاج إلى تثبيت إضافي.
التكوين
لا يتطلب تكويناً افتراضياً.
الاستخدام الأساسي
يوفر cURL العديد من خيارات سطر الأوامر لمهام نقل البيانات المختلفة. فيما يلي بعض الأمثلة الأساسية للاستخدام:
إرسال طلبات HTTP GET
bash
curl -X GET https://api.example.com/data
1
إرسال طلبات HTTP POST
bash
curl -X POST -d "param1=value1¶m2=value2" https://api.example.com/data
1
تنزيل الملفات
bash
curl -O https://example.com/file.zip
1
تحميل الملفات
bash
curl -X POST -F "file=@/path/to/file" https://api.example.com/upload
1
الاستخدام المتقدم
تعيين رؤوس HTTP
bash
curl -H "Content-Type: application/json" -H "Authorization: Bearer token" https://api.example.com/data
1
معالجة بيانات JSON
إرسال بيانات JSON
bash
curl -X POST -H "Content-Type: application/json" -d '{"key1":"value1", "key2":"value2"}' https://api.example.com/data
1
الحصول على واستعراض استجابة JSON (بالاشتراك مع jq)
bash
curl -s https://api.example.com/data | jq .
1
معالجة ملفات الكوكيز
حفظ الكوكيز إلى ملف
bash
curl -c cookies.txt https://example.com
1
استخدام ملف الكوكيز
bash
curl -b cookies.txt https://example.com
1
استخدام وكيل
bash
curl -x http://proxy.example.com:8080 https://api.example.com/data
1
تقييد معدل النقل
bash
curl --limit-rate 100K https://example.com/file.zip -O
1
استئناف التحميلات المتقطعة
bash
curl -C - -O https://example.com/largefile.zip
1
التحقق من صحة شهادة SSL
bash
curl --cacert /path/to/ca-bundle.crt https://secure.example.com
1
المشاكل الشائعة
1. لا يمكن تشغيل أمر cURL
- الحل: التحقق مما إذا كان cURL مثبتاً بشكل صحيح، والتأكد من أن مسار ملف التكوين صحيح. إذا استمرت المشكلة، يرجى مراجعة سجلات الأخطاء لمزيد من المعلومات.
2. ظهور أخطاء عند إرسال طلب
- الحل: التحقق من صحة عنوان URL والمعلمات المرسلة. التأكد من وجود اتصال شبكي سليم وأن الخادم الهدف يمكن الوصول إليه.
3. فشل تنزيل أو تحميل الملفات
- الحل: التحقق من صحة مسار الملف والأذونات. التأكد من أن الخادم الهدف يدعم عمليات نقل الملفات المطلوبة.
4. فشل التحقق من شهادة SSL
- الحل: التأكد من استخدام ملف شهادة CA الصحيح. يمكن استخدام الخيار
--insecure
لتجاهل التحقق من شهادة SSL (غير مستحسن في البيئات الإنتاجية).
bash
curl --insecure https://secure.example.com
1
الخاتمة
cURL هو أداة قوية ومرنة لسطر الأوامر مناسبة لمهام نقل البيانات المختلفة. من خلال هذه المقالة، يمكنك معرفة كيفية تثبيت وتكوين واستخدام cURL لإجراء طلبات HTTP، وتنزيل الملفات، واستدعاءات API على ServBay.