必须推荐给基友的Curl工具使用指南

3,538 阅读5分钟

curl是一个命令行工具,用于发送客户端请求。发送客户端请求大家常用的可能是类似postman等工具,但是为什么要使用curl呢?curl等最大优势在于随时随手可以发送,非常方便。比如很多场景下我们只是想快速验证一个请求或接口:

# 直接在命令行发送一个GET请求
curl https://xxx.com/api/v1/xxx

# 发送POST请求
curl -X POST -d "k1=123&k2=456" https://xxx.com/api/v1/xxx

image.png

curl安装

curl的安装就是到官网根据你的系统下载对应的版本进行安装,但是安装好后要配置环境变量。

# 安装好后重启终端运行,查看版本
curl -V

如果能看到如下内容则是安装成功了:

image.png

发送GET请求

  • curl后面直接添加url地址即可访问GET请求
curl https://www.baidu.com

请求百度网址的效果如下:

image.png

  • 发送GET请求携带请求参数
curl https://www.xxx.com/?key=value1&key2=value2

POST请求

-X POST --data "k1=v1&k2=v2"发送post请求,并且携带请求数据。下面演示一个接收POST请求并返回POST数据的的Node服务和CURL发送POST请求示例:

/**
 * http服务,处理post请求并将post数据返回
 */
const http = require('http');

const server = http.createServer((req, res) => {
  if (req.method === 'POST' && hasbody(req)) {
    const buffer = [];
    req.on('data', (chunk) => {
      buffer.push(chunk);
    });
    req.on('end', () => {
      const rawBody = Buffer.concat(buffer).toString();
      res.writeHead(200);
      res.end(rawBody);
    });
  } else {
    res.end('');
  }
});

server.listen(3000, () => {
  console.log('server running at port 3000.');
});

// 判断是否有body请求实体数据
function hasbody (req) {
  return req.headers['transfer-encoding'] !== undefined ||
    !isNaN(req.headers['content-length']);
}

curl发送post请求:

curl -X POST --data "key1=123&key2=456" http://localhost:3000

# --data可以简写为-d
curl -X POST -d "key1=123&key2=456" http://localhost:3000

image.png

  • post数据进行url编码
# 注意,--data-urlencode的简写不是-d
# --data的简写是-d
curl --data-urlencode "k1=1&k2=a b"  http://localhost:3000

例如下面发送对请求数据中,ab之间有个空格,使用--data-urlencode会对其进行encodeURIComponent编码:

image.png

发送HEAD请求

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200);
  res.end();
});

server.listen(3000, () => {
  console.log('server running at port 3000.');
});

-I 参数可以发送HEAD请求:

curl -I http://localhost:3000

image.png

发送DELETE请求

-X DELETE参数可以发送DELETE请求:

curl -X DELETE http://localhost:3000

image.png

发送PUT请求

下面起一个非常简易的node服务,将用户上传的图片保存成图片:

const http = require('http');
const fs = require('fs');

const server = http.createServer((req, res) => {
  // 如果是PUT请求且访问的接口是/upload/file
  if (req.method === 'PUT' && req.url === '/upload/file') {
    // 将用户的数据存成图片static/mime.png图片
    const writeStream = fs.createWriteStream(__dirname + '/static/mime.png');
    req.pipe(writeStream).on('finish', () => {
      res.writeHead(200);
      res.end('upload success');
    });
    writeStream.on('error', (err) => {
      res.writeHead(500);
      res.end('server error.');
    });
  }
});

server.listen(3000, () => {
  console.log('server running at port 3000.');
});

利用curl-T可以发送PUT类型请求,同时需要指定上传的资源路径:

curl -T ./mime.png http://localhost:3000/upload/file

image.png

同时请求结束后,可以看到上传的图片已经被保存下来了:

image.png

curl下载文件

下载保存文件是加-o 保存地址参数。

# 将baidu的html文件下载到本地
curl -o ./my-download.html https://www.baidu.com

curl命令执行的效果如下图,而且文件也已经被下载了下来:

image.png

查看响应头参数

-i参数可以返回响应头信息

curl -i  https://www.baidu.com

image.png

查看完整的报文信息

  • -v参数查看完整的报文信息
curl -v https://www.baidu.com

image.png

  • --trace ./log.txt查看更详细的信息并将数据写入到指定文件中。
curl --trace ./log.txt https://www.baidu.com

image.png

  • --trace-ascii ./log.txt以ascii编码格式查看更详细的信息并将数据写入到指定文件中。

指定请求的user-agent

我们启动一个最简单的http服务,并且配置好vscodedebug用于我们查看curl发送的信息:

const http = require('http');

const server = http.createServer((req, res) => {
  // 在此处打上断点,查看req请求对象
  res.end('');
});

server.listen(3000, () => {
  console.log('server running at port 3000.');
});

如果直接通过curl发送GET请求,可以看到user-agent为:

image.png

chrome浏览器的user-agentMozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.109 Safari/537.36

--user-agent "xxx"可以指定发送请求时的user-agent,参数简写为-A:

curl --user-agent "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.109 Safari/537.36" http://localhost:3000

# --user-agent简写为-A
curl -A "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.109 Safari/537.36" http://localhost:3000

image.png

指定请求的跳转

--referer 跳转前url 跳转后url

curl --referer http://localhost:3000 http://localhost:3000/newpath

此时发送的请求的req.url是新的地址http://localhost:3000/newpath,并且headers中携带了referer字段。

image.png

请求时携带cookie参数

  • --cookie "k1=v1&k2=v2"携带cookie参数,--cookie可以简写为-b:
curl --cookie "k=1&k2=2" http://localhost:3000

# --cookie简写为-b
curl -b "k=1&k2=2" http://localhost:3000

image.png

  • curl保存服务端的cookie到指定文件

为了使用curl时能携带服务端设置的cookie,我们可以先把服务的cookie存到本地,然后后续使用curl的适合再携带上。如下,有一个node设置cookie的例子:

const http = require('http');

const server = http.createServer((req, res) => {
  // Node设置cookie
  res.writeHead(200, {
    'Set-Cookie': 'key1=value1&key2=value2',
  });
  res.end('cookie set success.');
});

server.listen(3000, () => {
  console.log('server running at port 3000.');
});

通过curl发送请求携带-c path/to/save,可以将node设置的cookie保存到本地:

curl -c ./cookie http://localhost:3000

image.png

  • curl发送请求时携带cookie文件
curl -b ./cookie http://localhost:3000

此时debug可以看到req上已经携带了我们的cookie:

image.png

参考

结束语

curl对于想随手快速验证一个服务是非常便利的,而且真是越用越好用。希望小伙伴看完这篇教程之后能够使用起来,帮助到大家平日的开发工作。

我是你们的老朋友愣锤,喜欢这篇文章的小伙伴❤️❤️❤️,麻烦动动小手指点点赞哈👍👍👍!!! 你们的支持是我更文的动力,加油,奥利给!!!