「CURL」の版間の差分

2024年3月28日 (木) 01:20時点における最新版

cURL は URL を使ってデータを転送するためのコマンドラインツールおよびライブラリです。このコマンドは、HTTP、HTTPS、FTP、SCP や SFTP などさまざまなプロトコルをサポートしています。また、スクリプトのように、ユーザーの操作なしで動作するように設計されています。

ノート: 表面的には wget と同等ですが、違う部分もあります、こちらを参照してください。再帰的フェッチを実行できますか?、指定された wget コマンドと同等の curl コマンドを実行できますか? curl には無いもの

インストール

curl パッケージをインストールします。

使用方法

ダウンロード

cURL の一般的な使用例は、指定したファイルにリソースをダウンロードすることです:

$ curl --output file name URL

URL にファイル名が含まれている場合は、リソースをその名前のファイルに直接保存できます:

$ curl --remote-name URL

同様に、-J を使用すると、ファイルの名前を決めるためのヒントを HTTP サーバー (Content-Disposition ヘッダー) から受け取ることができます。-O と組み合わせると、HTTP サーバーが応答でファイル名のヒントを返さなかった場合は、curl は URL で指定されたファイル名を使用します。

また、出力オプションを省略して、リソースを標準出力に出力することもできます:

$ curl URL

HTTP POST

cURL を使用して HTTP POST リクエストを行うことができます。

$ curl -d 'request body' URL

リクエストの本文がコマンドラインに収まらない場合は、cURL はファイルからリクエストを読み込むことができます。

$ curl -d @file name URL

場合によっては、Content-Type ヘッダーにカスタム値を指定する必要があるかもしれません(cURL のデフォルト値は application/x-www-form-urlencoded)。これには -H を使います。例えば、JSON body を利用して、POST リクエストを作成する場合は以下のようにします。

$ curl -d 'json body' -H 'Content-Type: application/json' URL

なお、curl には json で投稿データを書き込み、それらのヘッダーを自動的に変更するオプションもあります: --json:

$ curl --json '{"key":"value"}' URL

ヒントとテクニック

リダイレクトを追跡する

リダイレクト (HTTP から HTTPS へのリダイレクトなど) を追跡するには:

$ curl --location URL

ダウンロードエラーを表示する

デフォルトでは、curl はエラーを無視します (たとえば、ファイルをダウンロードするときに、エラーが発生しても、curl は通知せず、空のファイルを作成します) エラーメッセージを表示させたい時は --fail を使います:

$ curl --fail URL

圧縮

データを圧縮して転送する場合 (たとえば、帯域幅が CPU よりも制限されている状況では、curl はデータを圧縮してダウンロードし、ダウンロード後に圧縮を解除します):

$ curl --compressed URL

プログレスバー

curl には、ファイルをダウンロードするときに通常の ProgressBar を使用するオプションがあります (例:[##### ] 80% )

$ curl --progress-bar URL

globing

また、curl で globing を使用することもできます。

$ curl "example.com/images/[1-9].png"
$ curl "example.com/{first_page,second_page,third_page}"

設定ファイル

curl はホームディレクトリと $XDG_CONFIG_HOME で .curlrc という config file を検索します。デフォルトの curl で使用したいコマンドライン引数を入力します。例:

$HOME/.curlrc

# this is a comment, the next line would be the option for progressbar:
-#
# to make curl always compress:
--compressed
# or just
compressed

参照

Wikipedia:ja:cURL
Everything curl - cURL の使用に関する広範なガイド
curl(1)

翻訳ステータス: このページは en:CURL の翻訳バージョンです。最後の翻訳日は 2024-03-28 です。もし英語版に変更があれば、翻訳の同期を手伝うことができます。

@@ 4行目: / 4行目: @@
 [[Category:ダウンロードユーティリティ]]
 [https://curl.haxx.se/ cURL] は URL を使ってデータを転送するためのコマンドラインツールおよびライブラリです。このコマンドは、[[HTTP]]、HTTPS、[[FTP]]、[[SCP]] や SFTP などさまざまなプロトコルをサポートしています。また、スクリプトのように、ユーザーの操作なしで動作するように設計されています。
+{{Note|表面的には wget と同等ですが、違う部分もあります、こちらを参照してください。[https://curl.se/docs/faq.html#Can_I_do_recursive_fetches_with 再帰的フェッチを実行できますか?]、[https://superuser.com/a/972282 指定された wget コマンドと同等の curl コマンドを実行できますか?] [https://curl.se/docs/faq.html#What_is_curl_not curl には無いもの]}}
 == インストール ==
@@ 13行目: / 15行目: @@
 === ダウンロード ===
-cURL の一般的な使用例は、指定したファイルにリソースをダウンロードすることです。
+cURL の一般的な使用例は、指定したファイルにリソースをダウンロードすることです:
- $ curl -o ''file name'' ''URL''
+ $ curl --output ''file name'' ''URL''
-URL にファイル名が含まれている場合は、リソースをその名前のファイルに直接保存できます。
+URL にファイル名が含まれている場合は、リソースをその名前のファイルに直接保存できます:
- $ curl -O ''URL''
+ $ curl --remote-name ''URL''
 同様に、{{ic|-J}} を使用すると、ファイルの名前を決めるためのヒントを HTTP サーバー ({{ic|Content-Disposition}} ヘッダー) から受け取ることができます。{{ic|-O}} と組み合わせると、HTTP サーバーが応答でファイル名のヒントを返さなかった場合は、curl は URL で指定されたファイル名を使用します。
-また、出力オプションを省略して、リソースを標準出力に出力することもできます。
+また、出力オプションを省略して、リソースを標準出力に出力することもできます:
  $ curl ''URL''
@@ 51行目: / 53行目: @@
 リダイレクト (HTTP から HTTPS へのリダイレクトなど) を追跡するには:
- $ curl -L ''URL''
+ $ curl --location ''URL''
 === ダウンロードエラーを表示する ===
-デフォルトでは、curl はエラーを無視します (たとえば、ファイルにダウンロードするとき、エラーが発生した場合、curl は通知せず、空のファイルが作成されます) そのため、{{ic|--fail}} を使用してエラーメッセージを表示させたい時:
+デフォルトでは、curl はエラーを無視します (たとえば、ファイルをダウンロードするときに、エラーが発生しても、curl は通知せず、空のファイルを作成します) エラーメッセージを表示させたい時は {{ic|--fail}} を使います:
  $ curl --fail ''URL''
@@ 97行目: / 99行目: @@
 * {{man|1|curl}}
-{{TranslationStatus|CURL|2023-11-20|691337}}
+{{TranslationStatus|CURL|2024-03-28|691337}}