今号では、curl コマンドの使い方やオプションについてご紹介します！
curl コマンドとは
curl コマンドは、様々な通信プロトコルでデータの送受信を行うことができるコマンドです。
よく使われる方法としては、Web サイトへ http リクエストを送信してコンテンツを表示する、等があります。
また様々なオプションを指定する事で、データ取得時の条件や、取得する情報を変える事ができます。
基本の書式
curl コマンドの基本の書式は以下の通りです。
http リクエストの場合ですと、以下の様に Web サイトのコンテンツがテキストで表示されます。
$ curl http://example.com This is example index page
また、コンマ (‘) や {} [] を使用する事で、アクセスする URL の範囲指定できます。
$ curl 'http://example[1-3].com' [1/3]: http://example1.com --> --_curl_--http://example1.com This is example1 index page [2/3]: http://example2.com --> --_curl_--http://example2.com This is example2 index page [3/3]: http://example3.com --> --_curl_--http://example3.com This is example3 index page
$ curl 'http://example-{one,two,three}.com'
[1/3]: http://example-one.com -->
--_curl_--http://example-one.com
This is example-one index page
[2/3]: http://example-two.com -->
--_curl_--http://example-two.com
This is example-two index page
[3/3]: http://example-three.com -->
--_curl_--http://example-three.com
This is example-three index page
curl コマンドのオプション
次に、curl コマンドで使用可能なオプションをご紹介します。
オプションには多くの種類がありますが、よく使用されると考えられるものを抜粋してご紹介します。
- コンテンツをファイル出力する
-o オプションを指定すると、取得したコンテンツをファイル出力します。$ curl http://example.com -o examplefile % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 27 100 27 0 0 3879 0 --:--:-- --:--:-- --:--:-- 4500 $ cat examplefile This is example index page※examplefile は、任意のファイル名に置き換えてください。 -o オプションに併せて -s オプションを指定すると、コンテンツ取得時の進捗状況を非表示にします。
$ curl http://example.com -s -o examplefile $ cat examplefile This is example index page
- SSL 接続による証明書エラーを無視する
自己署名証明書等、不正な証明書を使用するとエラーになりコンテンツが表示できない場合があります。
このエラーを無視してコンテンツを表示したい場合は -k オプションを指定します。# -kオプションがない場合 $curl https://example.com curl: (60) Peer's certificate issuer has been marked as not trusted by the user. More details here: http://curl.haxx.se/docs/sslcerts.html curl performs SSL certificate verification by default, using a "bundle" of Certificate Authority (CA) public keys (CA certs). If the default bundle file isn't adequate, you can specify an alternate file using the --cacert option. If this HTTPS server uses a certificate signed by a CA represented in the bundle, the certificate verification probably failed due to a problem with the certificate (it might be expired, or the name might not match the domain name in the URL). If you'd like to turn off curl's verification of the certificate, use the -k (or --insecure) option. # -kオプションがある場合 $ curl -k https://example.com This is example index page
- プロキシサーバを指定してアクセスする
-x オプションを指定すると、プロキシサーバ経由でアクセスします。$ curl -x http://proxy-example.com:3128 http://example.com …
※proxy-example.com:3128 は、任意の <プロキシサーバ>:<ポート番号> に置き換えてください。
- コンテンツ取得時の詳細なログを表示する
-v オプションを指定すると、コンテンツを取得した際の詳細なログ (レスポンスヘッダの内容や HTTP ステータスコード等) を表示します。$ curl -v http://example.com * About to connect() to example.com port 80 (#0) * Trying 127.0.0.1... * Connected to example.com (127.0.0.1) port 80 (#0) > GET / HTTP/1.1 > User-Agent: curl/7.29.0 > Host: example.com > Accept: */* > < HTTP/1.1 200 OK < Date: Wed, 20 Jul 2022 20:12:42 GMT < Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips < Last-Modified: Wed, 20 Jul 2022 19:15:01 GMT < ETag: "1b-5e4416af2a4ab" < Accept-Ranges: bytes < Content-Length: 27 < Content-Type: text/html; charset=UTF-8 < This is example index page * Connection #0 to host example.com left intact
- HTTP レスポンスヘッダを表示する
-I オプションを指定すると、コンテンツを取得した際の HTTP レスポンスヘッダの内容を表示します。$ curl -I http://example.com HTTP/1.1 200 OK Date: Wed, 20 Jul 2022 20:14:49 GMT Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips Last-Modified: Wed, 20 Jul 2022 19:15:01 GMT ETag: "1b-5e4416af2a4ab" Accept-Ranges: bytes Content-Length: 27 Content-Type: text/html; charset=UTF-8
