Bash

Linux – curlコマンドの使い方 – Webサーバーとの通信処理

2025-01-18更新日: 2025-01-18

curlコマンドは、LinuxでWebサーバーとの通信を行うためのツールです。

HTTPやHTTPSなどのプロトコルを使用して、リクエストを送信し、レスポンスを取得できます。

基本的な使い方は curl URL で、指定したURLに対してGETリクエストを送信します。

POSTリクエストを送信する場合は curl -X POST URL や curl -d 'data' URL を使用します。

ヘッダーの追加は -H 、レスポンスの保存は -o オプションで行います。

目次から探す

curlコマンドとは
- curlの主な特徴
curlコマンドの基本的な使い方
- 基本的な例
- curlコマンドのオプション
curlコマンドのオプション
curlコマンドの応用的な使い方
curlコマンドのエラーハンドリング
curlコマンドのセキュリティ
curlコマンドのスクリプトでの活用
まとめ

curlコマンドとは

curlコマンドは、URLを介してデータを転送するためのコマンドラインツールです。

主にHTTP、HTTPS、FTPなどのプロトコルを使用して、Webサーバーとの通信を行います。

curlは、さまざまなオプションを持ち、リクエストのカスタマイズやデータの取得、送信が可能です。

特に、APIとの連携やWebサービスのテストにおいて非常に便利です。

curlの主な特徴

多様なプロトコルのサポート: HTTP、HTTPS、FTP、FTPS、SFTPなど。
リクエストのカスタマイズ: ヘッダーやデータの送信方法を指定可能。
スクリプトとの統合: シェルスクリプトやプログラムから簡単に呼び出せる。
デバッグ機能: 通信の詳細な情報を表示するオプションがある。

curlコマンドは、シンプルな構文でありながら強力な機能を持っているため、Web開発者やシステム管理者にとって必須のツールとなっています。

curlコマンドの基本的な使い方

curlコマンドの基本的な使い方は非常にシンプルです。

基本的な構文は以下の通りです。

curl [オプション] [URL]

基本的な例

Webページの取得: 指定したURLのコンテンツを取得します。

curl https://www.example.com

<!doctype html>
<html>
<head>
    <title>Example Domain</title>
</head>
<body>
    <h1>Example Domain</h1>
    <p>This domain is for use in illustrative examples in documents.</p>
</body>
</html>

HTTPヘッダーの表示: -Iオプションを使用すると、HTTPヘッダーのみを表示できます。

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

HTTP/1.1 200 OK
Date: Mon, 01 Jan 2023 12:00:00 GMT
Server: Apache
Content-Type: text/html; charset=UTF-8

ファイルのダウンロード: -Oオプションを使用すると、指定したURLからファイルをダウンロードできます。

curl -O https://www.example.com/sample.txt

% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
Dload  Upload   Total   Spent    Left  Speed
100  1234  100  1234    0     0  1234      0 --:--:-- --:--:-- --:--:-- 1234

curlコマンドのオプション

curlコマンドには多くのオプションがあり、リクエストの詳細を制御できます。

以下は一般的なオプションの一部です。

オプション	説明
-I	HTTPヘッダーのみを表示
-O	ファイルをダウンロード
-d	POSTリクエストでデータを送信
-H	カスタムヘッダーを追加

これらの基本的な使い方を理解することで、curlコマンドを効果的に活用できるようになります。

curlコマンドのオプション

curlコマンドは多くのオプションを提供しており、リクエストの動作を細かく制御できます。

ここでは、よく使用されるオプションをいくつか紹介します。

一般的なオプション

オプション	説明
-X	使用する`HTTPメソッド`を指定(GET、POSTなど)
-d	POSTリクエストで送信するデータを指定
-H	カスタムHTTPヘッダーを追加
-u	ユーザー名とパスワードを指定(基本認証)
-L	リダイレクトを追従する
-o	出力を指定したファイルに保存
-s	進行状況を表示しない(サイレントモード)

具体的な使用例

HTTPメソッドの指定: -Xオプションを使用して、特定のHTTPメソッドを指定できます。

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

データの送信: -dオプションを使用して、POSTリクエストでデータを送信します。

curl -X POST -d "name=John&age=30" https://www.example.com/api

{"status":"success","message":"Data received."}

カスタムヘッダーの追加: -Hオプションを使用して、カスタムヘッダーを追加できます。

curl -H "Authorization: Bearer your_token" https://www.example.com/api

リダイレクトの追従: -Lオプションを使用すると、リダイレクトを自動的に追従します。

curl -L https://www.example.com/redirect

出力の保存: -oオプションを使用して、取得したデータをファイルに保存します。

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

その他の便利なオプション

オプション	説明
-k	SSL証明書の検証を無効にする
-v	詳細な通信情報を表示
–data-urlencode	URLエンコードされたデータを送信

これらのオプションを組み合わせることで、curlコマンドをより柔軟に活用し、さまざまな通信処理を行うことができます。

curlコマンドの応用的な使い方

curlコマンドは基本的な使い方だけでなく、さまざまな応用的な使い方が可能です。

ここでは、特に便利な応用例をいくつか紹介します。

1. APIとの連携

curlはAPIとの通信に非常に便利です。

例えば、JSON形式のデータをPOSTリクエストで送信する場合、以下のようにします。

curl -X POST -H "Content-Type: application/json" -d '{"name":"John","age":30}' https://api.example.com/users

{"status":"success","id":123}

2. ファイルのアップロード

curlを使用してファイルをサーバーにアップロードすることもできます。

-Fオプションを使って、フォームデータとしてファイルを送信します。

curl -X POST -F "file=@/path/to/file.txt" https://www.example.com/upload

{"status":"success","message":"File uploaded."}

3. 複数のリクエストを一度に実行

複数のURLに対して同時にリクエストを送信することも可能です。

以下のように、URLをスペースで区切って指定します。

curl https://www.example.com https://www.example.org

<!-- www.example.comの内容 -->
<!doctype html>...</html>
<!-- www.example.orgの内容 -->
<!doctype html>...</html>

4. プロキシを使用した通信

プロキシサーバーを経由して通信する場合、-xオプションを使用します。

以下はHTTPプロキシを指定する例です。

curl -x http://proxy.example.com:8080 https://www.example.com

<!doctype html>...</html>

5. 認証付きリクエスト

ベーシック認証やトークン認証を使用する場合、-uオプションやカスタムヘッダーを利用します。

curl -u username:password https://www.example.com/protected

<!doctype html>...</html>

6. スクリプトでの利用

curlはシェルスクリプトやバッチファイルに組み込むことができ、自動化処理に役立ちます。

以下は、シンプルなシェルスクリプトの例です。

#!/bin/bash
curl -s -o output.html https://www.example.com
echo "ダウンロード完了"

これらの応用的な使い方をマスターすることで、curlコマンドをさらに効果的に活用できるようになります。

curlコマンドのエラーハンドリング

curlコマンドを使用する際には、さまざまなエラーが発生する可能性があります。

これらのエラーを適切に処理することで、通信の信頼性を向上させることができます。

ここでは、curlコマンドのエラーハンドリングの方法について説明します。

1. エラーメッセージの確認

curlコマンドは、エラーが発生した場合に標準エラー出力にエラーメッセージを表示します。

これにより、問題の原因を特定する手助けになります。

例えば、URLが無効な場合、以下のようなエラーメッセージが表示されます。

curl https://invalid-url.example.com

curl: (6) Could not resolve host: invalid-url.example.com

2. ステータスコードの確認

HTTPリクエストの結果として返されるステータスコードを確認することで、リクエストが成功したかどうかを判断できます。

-oオプションと-wオプションを組み合わせて、ステータスコードを表示することができます。

curl -o output.html -w "%{http_code}" https://www.example.com

3. エラー時の処理をスクリプトに組み込む

シェルスクリプト内でcurlコマンドを使用する場合、エラーが発生した際の処理を組み込むことができます。

以下は、エラーが発生した場合にメッセージを表示する例です。

#!/bin/bash
response=$(curl -s -o output.html -w "%{http_code}" https://www.example.com)
if [ "$response" -ne 200 ]; then
    echo "エラーが発生しました: ステータスコード $response"
else
    echo "リクエスト成功"
fi

4. タイムアウトの設定

通信が遅延する場合に備えて、タイムアウトを設定することができます。

--connect-timeoutオプションを使用して、接続のタイムアウトを指定します。

curl --connect-timeout 5 https://www.example.com

この例では、接続が5秒以内に確立されない場合、エラーが発生します。

5. SSL証明書エラーの処理

SSL証明書に関するエラーが発生することがあります。

-kオプションを使用すると、SSL証明書の検証を無効にできますが、セキュリティ上のリスクがあるため、注意が必要です。

curl -k https://self-signed.badssl.com/

<!doctype html>...</html>

6. 詳細なデバッグ情報の表示

-vオプションを使用すると、curlの通信過程を詳細に表示することができます。

これにより、問題の診断が容易になります。

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

これらのエラーハンドリングのテクニックを活用することで、curlコマンドを使用した通信処理の信頼性を高めることができます。

curlコマンドのセキュリティ

curlコマンドを使用する際には、セキュリティに関する考慮が重要です。

特に、データの送受信や認証情報の取り扱いにおいて、適切な対策を講じることが求められます。

以下では、curlコマンドのセキュリティに関するポイントを紹介します。

1. HTTPSの使用

データを安全に送受信するためには、常にHTTPSを使用することが推奨されます。

HTTPSは、通信内容を暗号化し、第三者による盗聴や改ざんを防ぎます。

以下のように、URLに https:// を指定します。

curl https://www.example.com

2. SSL証明書の検証

curlはデフォルトでSSL証明書の検証を行いますが、自己署名証明書や無効な証明書を使用する場合、-kオプションを使って検証を無効にすることができます。

しかし、これはセキュリティリスクを伴うため、信頼できる環境でのみ使用するべきです。

curl -k https://self-signed.badssl.com/

3. 認証情報の安全な取り扱い

APIやサービスにアクセスする際に認証情報を使用する場合、コマンドラインに直接記述するのは避けるべきです。

代わりに、環境変数を使用するか、設定ファイルに保存して読み込む方法が推奨されます。

以下は、環境変数を使用する例です。

export API_TOKEN="your_token"
curl -H "Authorization: Bearer $API_TOKEN" https://api.example.com/data

4. データの送信時の暗号化

機密性の高いデータを送信する場合、データを暗号化してから送信することが重要です。

curl自体には暗号化機能はありませんが、OpenSSLなどのツールを使用してデータを暗号化し、その後curlで送信することができます。

echo "secret data" | openssl enc -aes-256-cbc -a -salt -pass pass:your_password | curl -X POST -d @- https://www.example.com/secure

5. リダイレクトの注意

-Lオプションを使用してリダイレクトを追従する際、信頼できないサイトにリダイレクトされる可能性があります。

これにより、フィッシングサイトに誘導されるリスクがあるため、リダイレクト先のURLを確認することが重要です。

6. ログの管理

curlコマンドの実行結果やエラーメッセージは、ログに記録されることがあります。

特に認証情報や機密データを含むリクエストのログは、適切に管理し、不要な情報が漏洩しないように注意が必要です。

ログファイルのアクセス権限を設定し、定期的に監査を行うことが推奨されます。

これらのセキュリティ対策を講じることで、curlコマンドを使用した通信処理の安全性を高めることができます。

curlコマンドのスクリプトでの活用

curlコマンドは、シェルスクリプトやバッチファイルに組み込むことで、自動化や定期的なタスクの実行に非常に便利です。

ここでは、curlコマンドをスクリプトで活用する方法をいくつか紹介します。

1. 定期的なデータ取得

curlを使用して、定期的にWebサイトやAPIからデータを取得するスクリプトを作成できます。

以下は、1時間ごとにデータを取得してファイルに保存する例です。

#!/bin/bash
while true; do
    curl -o data_$(date +%Y%m%d_%H%M%S).json https://api.example.com/data
    sleep 3600  # 1時間待機
done

2. エラーハンドリングを組み込む

スクリプト内でcurlコマンドを使用する際には、エラーハンドリングを組み込むことが重要です。

以下は、リクエストが失敗した場合に再試行する例です。

#!/bin/bash
url="https://www.example.com/api"
max_retries=5
count=0
while [ $count -lt $max_retries ]; do
    response=$(curl -s -o /dev/null -w "%{http_code}" $url)
    if [ "$response" -eq 200 ]; then
        echo "リクエスト成功"
        break
    else
        echo "リクエスト失敗: ステータスコード $response"
        count=$((count + 1))
        sleep 2  # 2秒待機
    fi
done

3. 複数のAPIエンドポイントへのリクエスト

複数のAPIエンドポイントに対してリクエストを送信するスクリプトを作成することも可能です。

以下は、複数のURLからデータを取得し、ファイルに保存する例です。

#!/bin/bash
urls=("https://api.example.com/data1" "https://api.example.com/data2")
for url in "${urls[@]}"; do
    filename=$(basename $url)
    curl -o "$filename.json" $url
done

4. 認証情報の管理

APIにアクセスする際に認証情報を使用する場合、スクリプト内で環境変数を利用することで、セキュリティを向上させることができます。

以下は、環境変数を使用してトークンを管理する例です。

#!/bin/bash
export API_TOKEN="your_token"
curl -H "Authorization: Bearer $API_TOKEN" https://api.example.com/protected

5. ログの記録

curlコマンドの実行結果をログファイルに記録することで、後から確認できるようにすることができます。

以下は、リクエストの結果をログファイルに保存する例です。

#!/bin/bash
url="https://www.example.com/api"
log_file="request.log"
response=$(curl -s -w "%{http_code}" -o /dev/null $url)
echo "$(date): $url - ステータスコード: $response" >> $log_file