curl命令使用详解

时间 2019-12-30

标签 curl 命令使用详解栏目 Linux 繁體版

原文原文链接

通用语法：
php

curl [option] [URL...]

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

curl的选项功能：node

不带任何参数时 curl 将返回指定url中的数据并打印在屏幕上linux
-u 使用用户名和密码登录。如curl -uname:passwd URLnginx
-b/--cookie <name=data> 向服务器提交cookie，若无=则name视为文件名，例如：curl -b cookie.txt www.jbxue.comweb
-o out 将指定curl返回保存为out文件，内容从html/jpg到各类MIME类型文件。如curl -o page.html URLjson
-d <key=value> 向服务器POST表单数据例如：curl -d "order=111&count=2" http://www.jbxue.com/buyapi
-A/--user-agent <ua> 指定发送请求的用户代理，例如：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 <file> 保存服务器的cookie文件
-e url 设置引用头的值
-T localfile 向服务器PUT文件例如：curl -T 1.mp3 www.jbxue.com/upload.php
-F <key=value> 向服务器POST表单，例如：curl -F "web=@index.html;type=text/html" url.com
-E cert.pem 指定本地证书
-H <header:value> 为HTTP请求设置任意header及值。如curl -H "Connection:keep-alive" http://www.jbxue.com
-X/--request method 用户定义的HTTP请求方法名如 curl -X GET www.baidu.com
--compressed 采用压缩方式接收返回数据
--connect-timeout <s> 设置超时时间
-v 详细输出，包含请求和响应的首部
--retry num
--retry timeo 指定重试的次数和间隔
--tcp-nodelay 打开TCP_NODELAY选项不进行捎带确认
-O 按服务器上的名称保存下载的文件
-r/--range from-to 下载指定range内的数据
-C 在保存文件时进行续传

环境变量：http_proxy [protocol://]<host>[: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

<!DOCTYPE html>
<html>
......
</html>

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
会获得以下提示：

<html>
<head><title>301 Moved Permanently</title></head>
<body bgcolor="white">
<center><h1>301 Moved Permanently</h1></center>
<hr><center>nginx/1.10.3</center>
</body>
</html>

而当咱们经过浏览器打开该连接时，会自动跳转到 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 完成请求所用的时间！

源文档：源文档连接