命令行神器curl：快速直接输出GET/POST请求结果 – wiki大全

作者： /

“`markdown

命令行神器curl：快速直接输出GET/POST请求结果

在日常开发和网络调试中，curl 无疑是命令行中最强大、最灵活的工具之一。它是一个利用 URL 语法在命令行下工作的文件传输工具，支持DICT, FILE, FTP, FTPS, Gopher, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, Telnet 和 TFTP 等多种协议。对于前端开发者、后端工程师或是任何需要与网络服务交互的人来说，掌握 curl 的基本用法，尤其是如何快速获取 GET 和 POST 请求结果，是提高效率的关键。

本文将详细介绍如何使用 curl 来执行 GET 和 POST 请求，并直接在命令行中输出结果。

1. curl 简介

curl 的全称是 “Client for URLs”，顾名思义，它是一个用于与服务器进行数据传输的客户端工具。它允许你发送各种类型的 HTTP 请求，并可以灵活地控制请求头、请求体、认证方式等，并将服务器的响应直接输出到标准输出 (stdout)。

2. 发送 GET 请求

GET 请求是最常见的 HTTP 请求类型，用于从服务器获取资源。使用 curl 发送 GET 请求非常简单。

2.1. 基本 GET 请求

只需在 curl 后面加上目标 URL 即可。

bash
curl https://api.example.com/data

这会向 https://api.example.com/data 发送一个 GET 请求，并将服务器返回的响应体（通常是 HTML、JSON 或 XML）直接打印到你的终端。

2.2. 查看响应头

默认情况下，curl 只会输出响应体。如果你想查看包括 HTTP 状态码、内容类型等在内的响应头，可以使用 -i 或 --include 选项：

bash
curl -i https://api.example.com/data

输出将包含响应头和响应体。

2.3. 增加详细输出 (Verbose Mode)

对于调试，-v 或 --verbose 选项非常有用。它会显示整个请求和响应过程的详细信息，包括连接建立、请求头发送、服务器响应等：

bash
curl -v https://api.example.com/data

2.4. 添加查询参数

GET 请求经常通过 URL 的查询字符串（query string）传递参数。你只需将完整的 URL 包含查询参数即可：

bash
curl "https://api.example.com/search?q=curl&limit=10"

注意：如果 URL 包含特殊字符（如 &），最好用双引号将其括起来，以防止 shell 误解析。

2.5. 自定义请求头

有时你需要设置特定的 User-Agent、Authorization 或 Accept 等请求头。使用 -H 或 --header 选项可以实现：

bash
curl -H "User-Agent: MyCustomClient/1.0" \
-H "Accept: application/json" \
"https://api.example.com/protected_data"

3. 发送 POST 请求

POST 请求通常用于向服务器提交数据，例如创建新资源或上传文件。

3.1. 发送表单数据 (Form Data)

最常见的 POST 请求是发送 application/x-www-form-urlencoded 类型的表单数据。使用 -d 或 --data 选项指定数据：

bash
curl -X POST \
-d "username=testuser&password=testpass" \
https://api.example.com/login

  • -X POST：显式指定请求方法为 POST。虽然在使用 -d 时 curl 会自动推断为 POST，但显式指定是个好习惯。
  • -d "key1=value1&key2=value2"：提交的数据，多个参数用 & 连接。curl 会自动设置 Content-Type 为 application/x-www-form-urlencoded。

3.2. 发送 JSON 数据

现代 Web API 经常使用 JSON 格式进行数据交换。发送 JSON 数据时，你需要：
1. 使用 -X POST 指定请求方法。
2. 使用 -H "Content-Type: application/json" 明确告诉服务器发送的数据是 JSON 格式。
3. 使用 -d 传递 JSON 字符串。

bash
curl -X POST \
-H "Content-Type: application/json" \
-d '{"name": "John Doe", "email": "[email protected]"}' \
https://api.example.com/users

注意：JSON 字符串需要用单引号 ' 包裹，以避免其中双引号 " 被 shell 误解析。

3.3. 从文件读取数据

如果 POST 的数据量较大，或者数据来自一个文件，你可以使用 @ 符号从文件中读取请求体：

“`bash

data.json 文件的内容: {“name”: “Jane Doe”, “email”: “[email protected]”}

curl -X POST \
-H “Content-Type: application/json” \
-d @data.json \
https://api.example.com/users
“`

3.4. 文件上传 (Multipart Form Data)

上传文件时，需要使用 -F 或 --form 选项来模拟浏览器中的 multipart/form-data 表单提交。

bash
curl -X POST \
-F "file=@/path/to/your/image.jpg" \
-F "description=A test image" \
https://api.example.com/upload

  • file=@/path/to/your/image.jpg： @ 符号指示 curl 读取本地文件并将其作为 file 字段的值发送。
  • description=A test image： 可以同时发送其他表单字段。

4. 常用 curl 选项

除了上述用于 GET/POST 请求的选项外，还有一些常用的 curl 选项能极大提升你的效率：

  • -s 或 --silent: 静默模式，不显示进度条或错误信息（除非指定 -S）。非常适合在脚本中使用。
    bash
    curl -s https://api.example.com/data
  • -S 或 --show-error: 在 -s 模式下显示错误信息。
  • -o <file> 或 --output <file>: 将服务器响应保存到指定文件，而不是输出到标准输出。
    bash
    curl https://api.example.com/big_file.zip -o big_file.zip
  • -O 或 --remote-name: 将服务器响应保存到本地文件，文件名与远程文件相同。
    bash
    curl -O https://api.example.com/image.jpg
  • -L 或 --location: 跟随 HTTP 3xx 重定向。
    bash
    curl -L http://shorturl.com/some-redirect
  • --compressed: 请求一个压缩的响应（如果服务器支持的话）。
    bash
    curl --compressed https://api.example.com/large_json_data
  • --user <username>:<password> 或 -u: 进行基本认证。
    bash
    curl -u "admin:secret" https://api.example.com/admin/status
  • -k 或 --insecure: 允许 curl 连接到 SSL/TLS 服务器而无需验证其证书（不推荐用于生产环境）。
    bash
    curl -k https://self-signed-cert.example.com/

5. 总结

curl 是一个功能极其强大的命令行工具，是进行网络请求和调试不可或缺的利器。通过灵活运用其各种选项，你可以轻松地发送 GET 和 POST 请求，无论是获取数据、提交表单、发送 JSON，还是上传文件，并能直接在命令行中观察和分析服务器的响应结果。熟练掌握 curl 将显著提升你在开发、测试和系统管理方面的效率。
“`

滚动至顶部