通用語法:
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 時,默認會發送 GET 請求來獲取連接內容到標準輸出。
curl http://www.codebelief.com
若是咱們只想要顯示 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>
咱們可使用 > 符號將輸出重定向到本地文件中。
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 選項手動指定文件名,或使用重定向符號。
咱們可使用 -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/
若是直接使用 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
這樣咱們就能獲取到通過重定向後的網頁內容了。
咱們可使用 -A 來自定義用戶代理,例以下面的命令將假裝成安卓火狐瀏覽器對網頁進行請求:
curl -A 「Mozilla/5.0 (Android; Mobile; rv:35.0) Gecko/35.0 Firefox/35.0」 http://www.baidu.com
下面咱們會使用 -H 來實現一樣的目的。
當咱們須要傳遞特定的 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
另外一種方式會在下面介紹。
當咱們使用 cURL 訪問頁面的時候,默認是不會保存 Cookie 的。有些狀況下咱們但願保存 Cookie 以便下次訪問時使用。例如登錄了某個網站,咱們但願再次訪問該網站時保持登錄的狀態,這時就能夠現將登錄時的 Cookie 保存起來,下次訪問時再讀取。
-c 後面跟上要保存的文件名。
curl -c 「cookie-example」 http://www.example.com
前面講到了使用 -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 的文件名。
咱們以登錄網頁爲例來進行說明使用 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 完成請求所用的時間!
源文檔:源文檔連接