tldr/pages.fa/common/curl.md

# curl

> انتقال داده از/به سرور.
> از اکثر پروتکل‌ها از جمله HTTP، FTP و POP3 پشتیبانی می‌کند.
> اطلاعات بیشتر: <https://curl.se/docs/manpage.html>.

- دانلود محتوای یک URL و ذخیره آن در یک فایل(با نام دلخواه):

`curl {{http://example.com}} {{[-o|--output]}} {{path/to/file}}`

- دانلود یک فایل و ذخیره آن با نام فایل مشخص شده توسط URL:

`curl {{[-O|--remote-name]}} {{http://example.com/filename}}`

- دانلود یک فایل، با دنبال کردن تغییرمسیرهای لینک(location redirects) و ادامه خودکار(از سرگیری) انتقال فایل قبلی. درصورت بروز دادن خطای سرور، خطا نمایش داده خواهد شد:

`curl {{[-f|--fail]}} {{[-O|--remote-name]}} {{[-L|--location]}} {{[-C|--continue-at]}} - {{http://example.com/filename}}`

- ارسال داده(فرم) رمزگذاری شده (درخواست POST از نوع application/x-www-form-urlencoded). برای خواندن از `stdin`، از --data @file_name یا --data @'-' استفاده کنید:

`curl {{[-d|--data]}} {{'name=bob'}} {{http://example.com/form}}`

- ارسال یک درخواست با استفاده از متود HTTP دلخواه و هدرهای(header) اضافی:

`curl {{[-H|--header]}} {{'X-My-Header: 123'}} {{[-X|--request]}} {{PUT}} {{http://example.com}}`

- ارسال داده به صورت JSON، با مشخص کردن content-type مناسب:

`curl {{[-d|--data]}} {{'{"name":"bob"}'}} {{[-H|--header]}} {{'Content-Type: application/json'}} {{http://example.com/users/1234}}`

- مشخص کردن یک نام کاربری و درخواست وارد کردن رمزعبور از سرور، به منظور احراز هویت:

`curl {{[-u|--user]}} {{username}} {{http://example.com}}`

- عبور از گواهی و کلید کاربر یک منبع(رد شدن از اعتبارسنجی گواهی):

`curl {{[-E|--cert]}} {{client.pem}} --key {{key.pem}} {{[-k|--insecure]}} {{https://example.com}}`