掌握curl：HTTP请求利器全面解析 – wiki基地

作者： /

掌握curl：HTTP请求利器全面解析

在当今高度互联的数字世界中，HTTP（超文本传输协议）是互联网数据交换的基石。无论是前端开发调试API、后端服务集成测试，还是系统管理员进行网络故障排查，一个强大而灵活的HTTP请求工具都是不可或缺的。而在这众多工具中，curl 无疑是命令行领域的一把瑞士军刀，以其无与伦比的功能和定制性，成为了开发者和工程师的HTTP请求利器。

本文将深入探讨 curl 的核心功能、常用场景及高级用法，助你全面掌握这一强大的命令行工具。

1. curl 是什么？

curl（Client for URLs）是一个命令行工具，用于传输数据到服务器或从服务器传输数据，支持多种协议，包括HTTP、HTTPS、FTP、FTPS、SCP、SFTP、TFTP、DICT、TELNET、LDAP、LDAPS、FILE、POP3、POP3S、IMAP、IMAPS、SMB、SMBS、SMTP、SMTPS、RTMP、RTSP、GOPHER和MQTT。尽管它支持如此多的协议，但最常见的用途无疑是进行HTTP/HTTPS请求。

2. 为什么选择 curl？

  • 跨平台兼容性：在几乎所有类Unix系统（Linux、macOS等）和Windows上都可使用。
  • 无需图形界面：纯命令行操作，适合脚本自动化、服务器环境和远程操作。
  • 强大的功能：支持几乎所有你能想象到的HTTP特性，如请求头定制、方法选择、数据上传、文件下载、认证、代理、Cookies、重定向控制等。
  • 调试和排查：详细的输出信息（包括请求和响应头）使其成为网络问题诊断的绝佳工具。

3. curl 的基本用法

最简单的 curl 命令就是请求一个URL并打印其内容到标准输出：

bash
curl https://www.example.com

4. 常用HTTP请求方法

HTTP请求方法（GET、POST、PUT、DELETE等）是与服务器交互的核心。

4.1 GET 请求

默认情况下，curl 执行的就是GET请求。

bash
curl https://api.example.com/users/123

4.2 POST 请求

POST请求通常用于向服务器提交数据，例如表单数据或JSON。

发送表单数据 (-d 或 --data)：

“`bash
curl -X POST -d “param1=value1&param2=value2” https://api.example.com/submit

简写，-X POST 可以省略，因为 -d 自动切换为 POST

curl -d “param1=value1&param2=value2” https://api.example.com/submit
“`

发送 JSON 数据 (-H "Content-Type: application/json" 和 -d)：

bash
curl -X POST \
-H "Content-Type: application/json" \
-d '{"name": "Alice", "age": 30}' \
https://api.example.com/users
注意：使用单引号 '' 包裹JSON字符串以避免shell解释特殊字符。

4.3 PUT、DELETE 等其他方法

使用 -X 或 --request 选项指定其他HTTP方法。

PUT 请求：

bash
curl -X PUT \
-H "Content-Type: application/json" \
-d '{"name": "Bob", "age": 25}' \
https://api.example.com/users/123

DELETE 请求：

bash
curl -X DELETE https://api.example.com/users/123

5. 请求头和认证

HTTP请求头提供了关于请求的附加信息，认证是访问受保护资源的关键。

5.1 自定义请求头 (-H 或 --header)

你可以设置任意数量的请求头。

bash
curl -H "User-Agent: MyCustomAgent/1.0" \
-H "Accept-Language: en-US,en;q=0.9" \
https://www.example.com

5.2 基本认证 (-u 或 --user)

对于HTTP基本认证，提供用户名和密码。

bash
curl -u "username:password" https://api.example.com/protected

5.3 Bearer Token 认证

Bearer Token通常通过 Authorization 头发送。

bash
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
https://api.example.com/data

6. 输出控制和调试

curl 提供了丰富的选项来控制输出和调试。

6.1 保存响应到文件 (-o 或 --output)

下载文件时非常有用。

“`bash
curl -o webpage.html https://www.example.com

或指定下载时的文件名

curl -o my_image.jpg https://example.com/images/cat.jpg
“`

6.2 显示请求和响应头 (-i 或 --include)

这会打印HTTP响应头，后跟页面内容。

bash
curl -i https://www.example.com

6.3 仅显示响应头 (-I 或 --head)

只执行HEAD请求，并只显示响应头，不下载内容。常用于检查资源是否存在或获取元信息。

bash
curl -I https://www.example.com

6.4 详细输出 (-v 或 --verbose)

显示请求和响应的详细过程，包括协议、端口、SSL握手信息、发送的请求头和接收的响应头。对于调试网络问题非常有用。

bash
curl -v https://www.example.com

6.5 显示更多调试信息 (--trace 或 --trace-ascii)

生成更详细的跟踪日志，可以输出到文件。

bash
curl --trace output.txt https://www.example.com
curl --trace-ascii output.txt https://www.example.com # 更可读的ASCII格式

6.6 仅显示HTTP响应码 (-w 或 --write-out)

结合 -s (静默模式) 使用，可以方便地获取HTTP状态码。

bash
curl -s -o /dev/null -w "%{http_code}\n" https://www.example.com

7. 高级功能

7.1 处理重定向 (-L 或 --location)

默认情况下，curl 不会跟随HTTP重定向（3xx状态码）。使用 -L 选项可以使其自动跟随。

bash
curl -L http://shorturl.at/abcde # 会跳转到最终的URL

7.2 Cookies (-b 和 -c)

发送 Cookies (-b 或 --cookie)：

“`bash

从文件中读取并发送cookies

curl -b cookies.txt https://api.example.com/profile

或者直接在命令行中指定

curl -b “session_id=abc; user=John” https://api.example.com/profile
“`

保存 Cookies (-c 或 --cookie-jar)：

bash
curl -c cookies.txt https://api.example.com/login # 登录后保存cookies

7.3 文件上传 (-F 或 --form)

模拟表单提交，常用于文件上传。

bash
curl -X POST \
-F "username=John Doe" \
-F "file=@/path/to/local/image.jpg" \
https://api.example.com/upload
注意：@ 符号表示上传本地文件。

7.4 代理 (-x 或 --proxy)

通过HTTP、HTTPS、SOCKS4、SOCKS5等代理服务器进行请求。

bash
curl -x http://your_proxy_host:port https://www.example.com
curl -x socks5://user:[email protected]:1080 https://www.example.com

7.5 超时设置 (--connect-timeout 和 --max-time)

  • --connect-timeout <seconds>: 限制连接阶段的最大时间。
  • --max-time <seconds>: 限制整个传输过程的最大时间。

bash
curl --connect-timeout 5 --max-time 10 https://slow.example.com

7.6 SSL/TLS 证书验证

默认情况下，curl 会验证SSL/TLS证书。如果你在开发或测试环境遇到证书问题，可以使用以下选项（但生产环境应避免）。

  • -k 或 --insecure: 允许 curl 在连接到SSL站点时跳过证书验证。
  • --cacert <file>: 指定一个CA证书文件来验证服务器证书。

bash
curl -k https://self-signed-cert.example.com # 忽略证书错误
curl --cacert my-ca-bundle.pem https://secure.example.com # 使用自定义CA

8. 结合管道和脚本

curl 的输出可以很容易地通过管道 (|) 传递给其他命令行工具，这使其在自动化脚本中非常强大。

获取API数据并用 jq 解析：

bash
curl -s https://api.github.com/users/octocat | jq .name

下载文件并实时显示进度：

bash
curl -O --progress-bar https://example.com/largefile.zip
--progress-bar 会显示一个文本进度条。-O 会将文件保存到当前目录，文件名与URL中的文件名相同。

总结

curl 是一个功能极其丰富的HTTP请求工具，掌握它意味着你拥有了在命令行中与Web服务进行高效交互的能力。从简单的GET请求到复杂的POST数据提交、文件上传、认证和调试，curl 都能胜任。通过熟悉本文介绍的常用选项和高级技巧，你将能够更有效地进行开发、测试和故障排查，极大地提升工作效率。下次需要进行HTTP请求时，不妨先从 curl 开始，体验它带来的强大和便捷。

滚动至顶部