curl手册

基本上是把curl的手册照着翻译了一遍。

语法 curl [options / URLs]

描述

curl 工具可用来与服务器传输数据，支持众多协议：DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET and TFTP。
该命令可在无需用户交互的情况下完成任务。

URL

• URL 的具体语法取决于使用的协议。

• 可以用花括号指定多个URL
  http://site.{one,two,three}.com

• 可以用方括号指定序列

  ftp://ftp.example.com/file[1-100].txt
ftp://ftp.example.com/file[001-100].txt
ftp://ftp.example.com/file[a-z].txt

• 序列不能嵌套，但可以先后指定多次
  http://example.com/archive[1996-1999]/vol[1-4]/part{a,b,c}.html

• 可以指定任意数量的url，curl命令会逐个处理。可以用任意顺序混合URL和命令行选项

• 方括号序列语法，还可以指定步长

  http://example.com/file[1-100:10].txt
http://example.com/file[a-z:2].txt

• 方括号和花括号是curl自身解析的，所以必要的时候用双引号括起来，避免Shell解析，类似的字符还有 *?&

• 如果省略协议，则默认值是 HTTP 协议，但curl会先尝试基于常用主机名签注猜测合适的协议，并且最终的
  比如，如果主机名以 ftp. 开头，则curl认为这是个 ftp 协议。

• curl 会在允许的情况下重用连接，如此从同一个服务器下载多个文件的时候就省去了创建连接的时间

进度条

curl 默认会显示进度条。
但如果有需要在终端显示的响应内容，则会关闭进度条，防止把内容搞混乱，此时使用 -o --output 选项
指示curl把相应内容写入文件则curl又会显示进度条。
使用 -# --progress-bar 使用另一种风格的进度条。
-s --silent 禁用进度条。

选项

选项以一个或者两个连字符开头，一个连字符的是短格式，两个连字符的是长格式。
大多数选项需要后面跟着选项值。
短个是选项和值之间的空格可以省略，但建议不要省略；长格式选项和值之间的空格必须保留。

少数选项不需要指定值，它们的短格式版本可以合并，比如 -O -L -v 可以写作-OLv。

布尔选项 --option 开启，对应使用 --no-option 关闭。

-K --config file

指定从文本文件中读取curl的选项，就好像把这些选项直接放到命令行上是一个效果。
选项文件中，选项和对应的值必须位于同一行。
选项和值之间以空格、冒号或等号分隔。
长选项可以省略开头的两个连字符，此时必须用冒号或等号作分隔符。

如果参数值中包含空格（或者参数以冒号、等号开头），则可以把参数值用引号括起。
在双引号中，有这个几个转移序列： \, ", \t, \n, \r, \v。其余字符前面的反斜杠会
被忽略。

井号开头的是注释。

文件名 - 表示标准输入。

记住，每个物理行只指定一个选项。

如果要在选项文件中指定url，需要使用这个选项 --url，而不能简单地直接把url写成一行。

curl启动时，会在如下位置查找默认配置文件（除非指定-q或–disable选项）：

1. 先确定“家目录”：依次检查环境变量 CURL_HOME, HOME, 如果失败，则
   • unix 上使用 getpwuid() 获取用户名，
   • windows上继续依次使用 APPDATA和’%USERPROFILE%\Application Data’。
2. 如果上一步找到了家目录，则使用其中的 .curlrc 作为配置文件，如果没有找到则，
   • unix 上，就不找了
   • windows 上，多尝试 curl 的安装目录。

举个例子

# --- Example file ---
# this is a comment
url = "example.com"
output = "curlhere.html"
user-agent = "superagent/1.0"

# and fetch another URL too
url = "example.com/docs/manpage.html"
-O
referer = "http://nowhereatall.example.com/"
# --- End of example file ---

待续……