Skip to content

דגלי curl מוסברים

הדגלים של curl שנמצאים בשימוש יומיומי, מקובצים לפי משימה: עיצוב הבקשה, הגדרת כותרות, אימות, הצגת זהות, שליטה בפלט, מעקב אחר הפניות, כיוונון החיבור וניפוי שגיאות. כל שורה משווה את הדגל לקריאה מציאותית.

curl שולח בקשת HTTP ומדפיס את גוף התגובה. רוב העוצמה שלו נמצאת בדגלים: הם בוחרים את השיטה, מצרפים כותרות ונתונים, מטפלים באימות ומחליטים מה יודפס. הצורה הארוכה מוצגת כשהיא ברורה יותר; הצורה הקצרה היא האות הבודדת. שימו כתובות URL במרכאות כפולות כדי שהמעטפת לא תטרוף את מחרוזת השאילתה.

טבלת עזר · 54 ערכים
54 of 54 rows
מבנה הבקשה
קובע את שיטת ה-HTTP.curl -X POST https://api.test
מוסיף כותרת בקשה.curl -H "Accept: application/json" URL
שולח גוף (קובע POST וסוג תוכן ברירת מחדל).curl -d "name=Ada" URL
מצרף ערכי -d כפרמטרים בשאילתה אל בקשת GET.curl -G -d "q=hi" URL
שולח נתוני טופס מרובה חלקים (העלאת קבצים).curl -F "file=@photo.png" URL
שולח נתוני טופס עם קידוד URL מיושם.curl --data-urlencode "name=Ada Lovelace" URL
מעלה קובץ עם PUT.curl -T big.zip URL
מוסיף את ההעלאה לקובץ המרוחק במקום להחליף אותו.curl -a -T log.txt ftp://server.test/logs/log.txt
JSON ו-API
שולח JSON עם סוג התוכן הנכון.curl -H "Content-Type: application/json" -d '{"a":1}' URL
שולח את תוכן הקובץ כגוף.curl -d @body.json URL
שולח JSON בלי להגדיר כותרות ידנית (curl 7.82+).curl --json '{"a":1}' URL
אימות
אימות HTTP Basic עם משתמש וסיסמה.curl -u ada:s3cr3t URL
שולח אסימון bearer של OAuth.curl --oauth2-bearer TOKEN URL
שולח כל סכמת אסימון באופן ידני.curl -H "Authorization: Bearer TOKEN" URL
מציג תעודת לקוח ואת המפתח שלה ל-TLS הדדי.curl --cert client.pem --key key.pem URL
מאמת את השרת מול קובץ חבילת CA אחד.curl --cacert ca.pem URL
מאמת את השרת מול ספריית רשויות אישורים.curl --capath /etc/ssl/certs URL
שולח את הבקשה דרך פרוקסי.curl -x http://proxy.test:8080 URL
מדלג על אימות TLS לקפיצה אל הפרוקסי בלבד.curl -x https://proxy.test:8443 --proxy-insecure URL
דורש TLS 1.3 כגרסה המינימלית.curl --tlsv1.3 URL
זהות
שולח מחרוזת User-Agent מותאמת אישית.curl -A "Mozilla/5.0" URL
שולח כותרת Referer.curl -e https://example.com/page URL
שולח עוגיות יחד עם הבקשה.curl -b "session=abc123" URL
שומר עוגיות תגובה לקובץ.curl -c cookies.txt URL
פלט
כותב את הגוף לקובץ.curl -o page.html URL
שומר את הגוף בשם הקובץ המרוחק.curl -O https://site/file.tgz
מדפיס כותרות תגובה מעל הגוף.curl -i URL
מאחזר כותרות בלבד (שולח HEAD).curl -I URL
מסתיר את מד ההתקדמות והשגיאות.curl -s URL
מדפיס מחרוזת פורמט אחרי הגוף (תזמון, סטטוס).curl -w "%{http_code}\n" -o /dev/null URL
יוצא עם קוד שאינו אפס בשגיאות HTTP ומדלג על גוף השגיאה.curl -f URL
יוצא עם קוד שאינו אפס בשגיאות HTTP אך עדיין מדפיס את הגוף.curl --fail-with-body URL
קורא לקובץ השמור בשם שנלקח מכותרת Content-Disposition.curl -OJ URL
ממשיך העברה שהופסקה מהנקודה שבה נעצרה.curl -C - -O URL
מציג סרגל התקדמות במקום המד המוגדר כברירת מחדל.curl -# -O URL
מדפיס שגיאות גם בפעולה שקטה.curl -sS URL
כותב את כותרות התגובה לקובץ.curl -D headers.txt URL
מבקש תגובה דחוסה ומפענח אותה.curl --compressed URL
יוצר ספריות חסרות בנתיב של -o.curl -o cache/api/data.json --create-dirs URL
הפניות וחיבור
עוקב אחר הפניות 3xx.curl -L URL
מספר שניות מקסימלי להמתנה לחיבור TCP.curl --connect-timeout 5 URL
מספר שניות מקסימלי לבקשה כולה.curl --max-time 30 URL
מדלג על אימות תעודת TLS.curl -k https://self-signed.test
מנסה מחדש שגיאות חולפות עד N פעמים.curl --retry 3 URL
מנסה מחדש בכל שגיאה, לא רק בחולפות.curl --retry 3 --retry-all-errors URL
כופה את החיבור דרך IPv4 או IPv6.curl -4 URL
ממפה שם מארח ופתחה לכתובת, תוך עקיפת DNS.curl --resolve api.test:443:127.0.0.1 https://api.test
קושר את ההעברה לממשק רשת או לכתובת.curl --interface eth0 URL
מעביר מספר כתובות URL בו-זמנית.curl -Z URL1 URL2
משתמש ב-HTTP/2 או HTTP/3 להעברה.curl --http3 URL
מזרים את הגוף כשהוא מגיע במקום לאגור אותו במטמון.curl -N URL
קורא דגלים נוספים מקובץ תצורה.curl -K flags.cfg URL
ניפוי שגיאות
מדפיס את מלוא חילופי הבקשה והתגובה.curl -v URL
ריקון הקסדצימלי של כל מה שנשלח והתקבל.curl --trace - URL