cURLとは？

on 開発

#🖥️ cURLとは？

cURL（カール）は、コマンドラインからHTTPリクエストを送信できるツールです。Web APIとの通信やファイルのダウンロードなど、さまざまな用途に使用されます。

📌 目次

  1. cURLの基本
  2. cURLのインストール
  3. 基本的な使い方
  4. HTTPメソッドの指定
  5. リクエストヘッダーの設定
  6. データの送信
  7. レスポンスの保存
  8. 認証が必要なリクエスト
  9. プロキシを経由する方法
  10. エラーの対処法
  11. まとめ

🔰 1. cURLの基本

cURLは、さまざまなプロトコル（HTTP、HTTPS、FTP など）をサポートし、簡単なコマンドでデータの送受信が可能です。

✅ 主な用途

  • WebページやAPIからデータを取得
  • ファイルのダウンロードやアップロード
  • ヘッダー情報の確認
  • APIの動作テスト

💻 2. cURLのインストール

Windowsの場合

  1. cURL公式サイトからダウンロード
  2. curl.exe を環境変数 PATH に追加

macOSの場合

brew install curl

Linuxの場合

sudo apt install curl  # Debian系
sudo yum install curl  # RedHat系

📄 3. 基本的な使い方

Webページの取得（GETリクエスト）

curl https://example.com

HTTPS通信の場合

curl -k https://example.com

🔄 4. HTTPメソッドの指定

GETリクエスト（デフォルト）

curl -X GET https://example.com

POSTリクエスト

curl -X POST https://example.com

PUTリクエスト

curl -X PUT https://example.com

DELETEリクエスト

curl -X DELETE https://example.com

🎭 5. リクエストヘッダーの設定

カスタムヘッダーを追加するには -H オプションを使用します。

curl -H "Authorization: Bearer token123" https://example.com

📨 6. データの送信

JSONデータを送信する

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

フォームデータを送信する

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

📥 7. レスポンスの保存

ファイルに保存するには -o オプションを使用します。

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

🔑 8. 認証が必要なリクエスト

Basic認証

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

Bearerトークン認証

curl -H "Authorization: Bearer token123" https://example.com

🌐 9. プロキシを経由する方法

プロキシサーバーを指定するには -x オプションを使用します。

curl -x http://proxyserver:8080 https://example.com

❌ 10. エラーの対処法

✅ curl: command not found

  • cURLがインストールされているか確認

✅ SSL certificate problem

  • -k オプションを使用するか証明書を適切に設定

✅ Could not resolve host

  • URLが正しいか確認し、DNS設定をチェック

🏆 11. まとめ

  • cURLはHTTPリクエストをコマンドラインで簡単に実行できるツール
  • GET・POST・PUT・DELETE などのHTTPメソッドを使用可能
  • リクエストヘッダーや認証情報を簡単に追加できる
  • データの送受信やレスポンスの保存も可能

cURLを活用して、Web APIやデータ通信を効率的に行いましょう！ 🚀