curl 的用法指南

阮一峰發表於2019-09-05

簡介

curl 是常用的命令列工具,用來請求 Web 伺服器。它的名字就是客戶端(client)的 URL 工具的意思。

它的功能非常強大,命令列引數多達幾十種。如果熟練的話,完全可以取代 Postman 這一類的圖形介面工具。

本文介紹它的主要命令列引數,作為日常的參考,方便查閱。內容主要翻譯自《curl cookbook》。為了節約篇幅,下面的例子不包括執行時的輸出,初學者可以先看我以前寫的《curl 初學者教程》

不帶有任何引數時,curl 就是發出 GET 請求。


$ curl https://www.example.com

上面命令向www.example.com發出 GET 請求,伺服器返回的內容會在命令列輸出。

-A

-A引數指定客戶端的使用者代理標頭,即User-Agent。curl 的預設使用者代理字串是curl/[version]


$ curl -A 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.100 Safari/537.36' https://google.com

上面命令將User-Agent改成 Chrome 瀏覽器。


$ curl -A '' https://google.com

上面命令會移除User-Agent標頭。

也可以透過-H引數直接指定標頭,更改User-Agent


$ curl -H 'User-Agent: php/1.0' https://google.com

-b

-b引數用來向伺服器傳送 Cookie。


$ curl -b 'foo=bar' https://google.com

上面命令會生成一個標頭Cookie: foo=bar,向伺服器傳送一個名為foo、值為bar的 Cookie。


$ curl -b 'foo1=bar;foo2=bar2' https://google.com

上面命令傳送兩個 Cookie。


$ curl -b cookies.txt https://www.google.com

上面命令讀取本地檔案cookies.txt,裡面是伺服器設定的 Cookie(參見-c引數),將其傳送到伺服器。

-c

-c引數將伺服器設定的 Cookie 寫入一個檔案。


$ curl -c cookies.txt https://www.google.com

上面命令將伺服器的 HTTP 回應所設定 Cookie 寫入文字檔案cookies.txt

-d

-d引數用於傳送 POST 請求的資料體。


$ curl -d'login=emma&password=123'-X POST https://google.com/login
# 或者
$ curl -d 'login=emma' -d 'password=123' -X POST  https://google.com/login

使用-d引數以後,HTTP 請求會自動加上標頭Content-Type : application/x-www-form-urlencoded。並且會自動將請求轉為 POST 方法,因此可以省略-X POST

-d引數可以讀取本地文字檔案的資料,向伺服器傳送。


$ curl -d '@data.txt' https://google.com/login

上面命令讀取data.txt檔案的內容,作為資料體向伺服器傳送。

--data-urlencode

--data-urlencode引數等同於-d,傳送 POST 請求的資料體,區別在於會自動將傳送的資料進行 URL 編碼。


$ curl --data-urlencode 'comment=hello world' https://google.com/login

上面程式碼中,傳送的資料hello world之間有一個空格,需要進行 URL 編碼。

-e

-e引數用來設定 HTTP 的標頭Referer,表示請求的來源。


curl -e 'https://google.com?q=example' https://www.example.com

上面命令將Referer標頭設為https://google.com?q=example

-H引數可以透過直接新增標頭Referer,達到同樣效果。


curl -H 'Referer: https://google.com?q=example' https://www.example.com

-F

-F引數用來向伺服器上傳二進位制檔案。


$ curl -F '[email protected]' https://google.com/profile

上面命令會給 HTTP 請求加上標頭Content-Type: multipart/form-data,然後將檔案photo.png作為file欄位上傳。

-F引數可以指定 MIME 型別。


$ curl -F '[email protected];type=image/png' https://google.com/profile

上面命令指定 MIME 型別為image/png,否則 curl 會把 MIME 型別設為application/octet-stream

-F引數也可以指定檔名。


$ curl -F '[email protected];filename=me.png' https://google.com/profile

上面命令中,原始檔名為photo.png,但是伺服器接收到的檔名為me.png

-G

-G引數用來構造 URL 的查詢字串。


$ curl -G -d 'q=kitties' -d 'count=20' https://google.com/search

上面命令會發出一個 GET 請求,實際請求的 URL 為https://google.com/search?q=kitties&count=20。如果省略--G,會發出一個 POST 請求。

如果資料需要 URL 編碼,可以結合--data--urlencode引數。


$ curl -G --data-urlencode 'comment=hello world' https://www.example.com

-H

-H引數新增 HTTP 請求的標頭。


$ curl -H 'Accept-Language: en-US' https://google.com

上面命令新增 HTTP 標頭Accept-Language: en-US


$ curl -H 'Accept-Language: en-US' -H 'Secret-Message: xyzzy' https://google.com

上面命令新增兩個 HTTP 標頭。


$ curl -d '{"login": "emma", "pass": "123"}' -H 'Content-Type: application/json' https://google.com/login

上面命令新增 HTTP 請求的標頭是Content-Type: application/json,然後用-d引數傳送 JSON 資料。

-i

-i引數列印出伺服器回應的 HTTP 標頭。


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

上面命令收到伺服器回應後,先輸出伺服器回應的標頭,然後空一行,再輸出網頁的原始碼。

-I

-I引數向伺服器發出 HEAD 請求,然會將伺服器返回的 HTTP 標頭列印出來。


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

上面命令輸出伺服器對 HEAD 請求的回應。

--head引數等同於-I


$ curl --head https://www.example.com

-k

-k引數指定跳過 SSL 檢測。


$ curl -k https://www.example.com

上面命令不會檢查伺服器的 SSL 證照是否正確。

-L

-L引數會讓 HTTP 請求跟隨伺服器的重定向。curl 預設不跟隨重定向。


$ curl -L -d 'tweet=hi' https://api.twitter.com/tweet

--limit-rate

--limit-rate用來限制 HTTP 請求和回應的頻寬,模擬慢網速的環境。


$ curl --limit-rate 200k https://google.com

上面命令將頻寬限制在每秒 200K 位元組。

-o

-o引數將伺服器的回應儲存成檔案,等同於wget命令。


$ curl -o example.html https://www.example.com

上面命令將www.example.com儲存成example.html

-O

-O引數將伺服器回應儲存成檔案,並將 URL 的最後部分當作檔名。


$ curl -O https://www.example.com/foo/bar.html

上面命令將伺服器回應儲存成檔案,檔名為bar.html

-s

-s引數將不輸出錯誤和進度資訊。


$ curl -s https://www.example.com

上面命令一旦發生錯誤,不會顯示錯誤資訊。不發生錯誤的話,會正常顯示執行結果。

如果想讓 curl 不產生任何輸出,可以使用下面的命令。


$ curl -s -o /dev/null https://google.com

-S

-S引數指定只輸出錯誤資訊,通常與-s一起使用。


$ curl -s -o /dev/null https://google.com

上面命令沒有任何輸出,除非發生錯誤。

-u

-u引數用來設定伺服器認證的使用者名稱和密碼。


$ curl -u 'bob:12345' https://google.com/login

上面命令設定使用者名稱為bob,密碼為12345,然後將其轉為 HTTP 標頭Authorization: Basic Ym9iOjEyMzQ1

curl 能夠識別 URL 裡面的使用者名稱和密碼。


$ curl https://bob:[email protected]/login

上面命令能夠識別 URL 裡面的使用者名稱和密碼,將其轉為上個例子裡面的 HTTP 標頭。


$ curl -u 'bob' https://google.com/login

上面命令只設定了使用者名稱,執行後,curl 會提示使用者輸入密碼。

-v

-v引數輸出通訊的整個過程,用於除錯。


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

--trace引數也可以用於除錯,還會輸出原始的二進位制資料。


$ curl --trace - https://www.example.com

-x

-x引數指定 HTTP 請求的代理。


$ curl -x socks5://james:[email protected]:8080 https://www.example.com

上面命令指定 HTTP 請求透過myproxy.com:8080的 socks5 代理發出。

如果沒有指定代理協議,預設為 HTTP。


$ curl -x james:[email protected]:8080 https://www.example.com

上面命令中,請求的代理使用 HTTP 協議。

-X

-X引數指定 HTTP 請求的方法。


$ curl -X POST https://www.example.com

上面命令對https://www.example.com發出 POST 請求。

參考連結

(完)

相關文章