מתי להשתמש ב-curl
השתמש ב-curl כדי לבדוק תגובות HTTP, להוריד משאב או להתקשר ל-API מהשרת. הפרד בין הצלחה בהעברה לבין הצלחה ביישום, הגדר פסק זמן הגיוני והרחיק אסימוני אימות מדוגמאות פקודות שמורות.
תחביר
curl [PARAMETERS] URLסוגריים מרובעים מסמנים טיעונים אופציונליים; אליפסיס פירושו חזרה. החלף שמות קבצים לדוגמה, שמות משתמש וכתובות שרתים בערכים משלך.
אפשרויות וטיעונים נפוצים
דוגמאות לשימוש
בדוק את כותרות האתר
curl -I https://example.comמוגשת בקשה לכותרת בלבד; שירותים מסוימים מטפלים בזה אחרת מבקשת תוכן רגילה.
הורד קובץ עם עיבוד של שגיאות HTTP
curl --fail --location --output ./page.html https://example.comעוקבים אחר הפניות מחדש וגוף התגובה מחליף את הקובץ המקומי בעל השם; מצבי שגיאה HTTP גורמים לכשל.
בקש JSON עם הגבלת זמן
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/statusמתבקשת תגובת JSON עם משך כולל מוגבל; נקודת הקצה חייבת לספק את ה-API הזה.
הערות ומגבלות
- עם HTTPS האישור מאומת כברירת מחדל; אין להשבית בדיקה דרך -k ללא סיבה נפרדת.
- אל תציב אסימונים או סיסמאות אמיתיות בהיסטוריית הפקודות ואל תפעיל סקריפטים שהורדת ללא אימות.
שאלות נפוצות ופתרון בעיות
מדוע curl מצליח כאשר השרת מחזיר דף שגיאה?
ללא אפשרות הכשל, קבלת תגובת שגיאה HTTP עדיין יכולה להיחשב כהעברה מוצלחת. בדוק גם את מצב HTTP וגם את מצב יציאת הפקודה.
האם עלי להשבית את אימות האישור כדי לתקן את HTTPS?
אל תעקוף אמון כתיקון שגרתי. בדוק במקום זאת את שם המארח, זמן המערכת, שרשרת אישורי השרת ותצורת CA מהימן.
עזרה נוספת
האפשרויות משתנות לפי גרסה והפצה. בדוק את התיעוד המותקן באמצעות הפקודה הזו: man curl.