通用语法:

curl [option] [URL...]

在处理URL时其支持类型于SHELL的名称扩展功能,如http://www.jbxue.com/archive[1996-1999]/vol[1-4]/part{a,b,c}.html可以生成多个期望的URL

curl的选项功能:

  • 不带任何参数时 curl 将返回指定url中的数据并打印在屏幕上

  • -u 使用用户名和密码登陆。如curl -uname:passwd URL

  • -b/--cookie     向服务器提交cookie,若无=则name视为文件名,例如:curl -b cookie.txt www.jbxue.com

  • -o out  将指定curl返回保存为out文件,内容从html/jpg到各种MIME类型文件。如curl -o page.html URL

  • -d   向服务器POST表单数据 例如:curl -d "order=111&count=2" http://www.jbxue.com/buy

  • -A/--user-agent    指定发送请求的用户代理,例如:curl -A My-Agent/1.0.0 www.jbxue.com 

  • -x  ip:port 指定使用的http代理,例如:curl -x 192.168.1.1:8080 www.jbxue.com

  • -D head.txt  将服务器的返回的header保存为文件,头部的cookie也可被保存,例如:curl -D header.txt www.jbxue.com  

    • 如果希望从本地文件中获取表单数据,则在文件名前加@ ,例如:curl -d @data.xml http://www.jbxue.com

    • 若希望从标准输入获取则用 curl -d "name=username&passwd=pwd" http://www.jbxue.com

  • -L 当页面有跳转的时候,输出跳转到的页面

  • -I  header信息  当有跳转时,可以通过 curl -L -I URL|grep Location 来确定跳转到的新url地址

  • -c 保存服务器的cookie文件

  • -e url  设置引用头的值

  • -T localfile  向服务器PUT文件 例如:curl -T 1.mp3  www.jbxue.com/upload.php

  • -F 向服务器POST表单,例如:curl -F "[email protected];type=text/html" url.com

  • -E cert.pem  指定本地证书

  • -H   为HTTP请求设置任意header及值。如curl -H "Connection:keep-alive" http://www.jbxue.com

  • -X/--request method 用户定义的HTTP请求方法名如 curl -X GET www.baidu.com

  • --compressed 采用压缩方式接收返回数据

  • --connect-timeout 设置超时时间

  • -v 详细输出,包含请求和响应的首部

  • --retry num

  • --retry timeo 指定重试的次数和间隔

  • --tcp-nodelay 打开TCP_NODELAY选项  不进行捎带确认

  • -O  按服务器上的名称保存下载的文件

  • -r/--range  from-to 下载指定range内的数据

  • -C 在保存文件时进行续传

环境 变量:http_proxy [protocol://][:port]


CURL 的十种常见用法


1. 获取页面内容

当我们不加任何选项使用 curl 时,默认会发送 GET 请求来获取链接内容到标准输出。 
curl http://www.codebelief.com

2. 显示 HTTP 头

如果我们只想要显示 HTTP 头,而不显示文件内容,可以使用 -I 选项: 
curl -I http://www.codebelief.com 
输出为:

HTTP/1.1 200 OK
Server: nginx/1.10.3
Date: Thu, 11 May 2017 08:24:45 GMT
Content-Type: text/html; charset=utf-8
Content-Length: 24206
Connection: keep-alive
X-Powered-By: Express
Cache-Control: public, max-age=0
ETag: W/"5e8e-Yw5ZdnVVly9/aEnMX7fVXQ"
Vary: Accept-Encoding

也可以同时显示 HTTP 头和文件内容,使用 -i 选项: 
curl -i http://www.codebelief.com 
输出为:

HTTP/1.1 200 OK
Server: nginx/1.10.3
Date: Thu, 11 May 2017 08:25:46 GMT
Content-Type: text/html; charset=utf-8
Content-Length: 24206
Connection: keep-alive
X-Powered-By: Express
Cache-Control: public, max-age=0
ETag: W/"5e8e-Yw5ZdnVVly9/aEnMX7fVXQ"
Vary: Accept-Encoding



......

3. 将链接保存到文件

我们可以使用 > 符号将输出重定向到本地文件中。 
curl http://www.codebelief.com > index.html 
也可以通过 curl 自带的 -o/-O 选项将内容保存到文件中。

-o(小写的 o):结果会被保存到命令行中提供的文件名 
-O(大写的 O):URL 中的文件名会被用作保存输出的文件名 
curl -o index.html http://www.codebelief.com 
curl -O http://www.codebelief.com/page/2/ 
注意:使用 -O 选项时,必须确保链接末尾包含文件名,否则 curl 无法正确保存文件。如果遇到链接中无文件名的情况,应该使用 -o 选项手动指定文件名,或使用重定向符号。

4. 同时下载多个文件

我们可以使用 -o 或 -O 选项来同时指定多个链接,按照以下格式编写命令: 
curl -O http://www.codebelief.com/page/2/ -O http://www.codebelief.com/page/3/

或者: 
curl -o page1.html http://www.codebelief.com/page/1/ -o page2.html http://www.codebelief.com/page/2/

5. 使用 -L 跟随链接重定向

如果直接使用 curl 打开某些被重定向后的链接,这种情况下就无法获取我们想要的网页内容。例如: 
curl http://codebelief.com 
会得到如下提示:


301 Moved Permanently

301 Moved Permanently


nginx/1.10.3

而当我们通过浏览器打开该链接时,会自动跳转到 http://www.codebelief.com。此时我们想要 curl 做的,就是像浏览器一样跟随链接的跳转,获取最终的网页内容。我们可以在命令中添加 -L 选项来跟随链接重定向:

curl -L http://codebelief.com 
这样我们就能获取到经过重定向后的网页内容了。

6. 使用 -A 自定义 User-Agent

我们可以使用 -A 来自定义用户代理,例如下面的命令将伪装成安卓火狐浏览器对网页进行请求: 
curl -A “Mozilla/5.0 (Android; Mobile; rv:35.0) Gecko/35.0 Firefox/35.0” http://www.baidu.com 
下面我们会使用 -H 来实现同样的目的。

7. 使用 -H 自定义 header

当我们需要传递特定的 header 的时候,可以仿照以下命令来写: 
curl -H “Referer: www.example.com” -H “User-Agent: Custom-User-Agent” http://www.baidu.com 
可以看到,当我们使用 -H 来自定义 User-Agent 时,需要使用 “User-Agent: xxx” 的格式。

我们能够直接在 header 中传递 Cookie,格式与上面的例子一样: 
curl -H “Cookie: JSESSIONID=D0112A5063D938586B659EF8F939BE24” http://www.example.com 
另一种方式会在下面介绍。

8. 使用 -c 保存 Cookie

当我们使用 cURL 访问页面的时候,默认是不会保存 Cookie 的。有些情况下我们希望保存 Cookie 以便下次访问时使用。例如登陆了某个网站,我们希望再次访问该网站时保持登陆的状态,这时就可以现将登陆时的 Cookie 保存起来,下次访问时再读取。

-c 后面跟上要保存的文件名。 
curl -c “cookie-example” http://www.example.com

9. 使用 -b 读取 Cookie

前面讲到了使用 -H 来发送 Cookie 的方法,这种方式是直接将 Cookie 字符串写在命令中。如果使用 -b 来自定义 Cookie,命令如下: 
curl -b “JSESSIONID=D0112A5063D938586B659EF8F939BE24” http://www.example.com 
如果要从文件中读取 Cookie,-H 就无能为力了,此时可以使用 -b 来达到这一目的: 
curl -b “cookie-example” http://www.example.com 
即 -b 后面既可以是 Cookie 字符串,也可以是保存了 Cookie 的文件名。

10. 使用 -d 发送 POST 请求

我们以登陆网页为例来进行说明使用 cURL 发送 POST 请求的方法。假设有一个登录页面 www.example.com/login,只需要提交用户名和密码便可登录。我们可以使用 cURL 来完成这一 POST 请求,-d 用于指定发送的数据,-X 用于指定发送数据的方式: 
curl -d “userName=tom&passwd=123456” -X POST http://www.example.com/login

在使用 -d 的情况下,如果省略 -X,则默认为 POST 方式: 
curl -d “userName=tom&passwd=123456” http://www.example.com/login

强制使用 GET 方式 
发送数据时,不仅可以使用 POST 方式,也可以使用 GET 方式,例如: 
curl -d “somedata” -X GET http://www.example.com/api

或者使用 -G 选项: 
curl -d “somedata” -G http://www.example.com/api

从文件中读取 data 
curl -d “@data.txt” http://www.example.com/login

带 Cookie 登录 
当然,如果我们再次访问该网站,仍然会变成未登录的状态。我们可以用之前提到的方法保存 Cookie,在每次访问网站时都带上该 Cookie 以保持登录状态。 
curl -c “cookie-login” -d “userName=tom&passwd=123456” http://www.example.com/login 
再次访问该网站时,使用以下命令: 
curl -b “cookie-login” http://www.example.com/login 
这样,就能保持访问的是登录后的页面了。


常用操作:

需要传递用户名密码校验的请求

curl -u username:pass http://www.xxx.com

需要传递token校验的请求

curl -H "Authorization token:xxxxxx"  http://www.xxx.com

需要指定http method的请求

curl -H "ContentType: text" --request GET\DELETE\PUT http://www.xxxx.com

只获取header信息

curl -I http://www.xxx.com

提交数据json格式

curl -H ""Content-Type: application/json"  -d '{"name":"name"}--request GET\DELETE\PUT http://www.xxxx.com
curl -H ""Content-Type: application/json"  -d 'a=1&b=2' --request GET\DELETE\PUT http://www.xxxx.com

使用 cURL 度量 Web 站点的响应时间

$curl -o /dev/null -s -w %{time_connect}:%{time_starttransfer}:%{time_total} http://www.xxx.com
0.081:0.272:0.779

通过 -o 参数发送到 /dev/null。 -s 参数去掉所有状态信息。-w参数让 curl 写出列出的计时器的状态信息:

time_connect     建立到服务器的 TCP 连接所用的时间

time_starttransfer     在发出请求之后,Web 服务器返回数据的第一个字节所用的时间

time_total         完成请求所用的时间!





源文档:源文档链接