PHP で cURL を使用してリモート API 呼び出しを行う方法

今日の Web サイト アプリケーションでは、API を介してリモート サービスを呼び出すことが非常に一般的な要件になっています。 PHP はリモート API 呼び出しを実装するための API を多数提供していますが、その中で cURL はよく使用されます。 cURL を使用すると、リモート サービスにリクエストを送信し、HTTP/HTTPS プロトコルを通じて対応するデータを取得するのに非常に便利です。この記事では、PHP で cURL を使用してリモート API 呼び出しを行う方法を紹介し、いくつかの一般的なアプリケーション シナリオを示します。

cURL のインストール
cURL の使用を開始する前に、まず PHP 環境に cURL モジュールをインストールする必要があります。 Windows システムを使用している場合は、php.ini ファイル内の extension=php_curl.dll のコメントを解除することで、cURL 拡張機能を有効にできます。 Linux または Mac システムを使用している場合は、次のコマンドを使用して cURL 拡張機能をインストールできます:

sudo apt-get install php-curl

または

sudo yum install php-curl

これにより、PHP で cURL を使用してリモート リクエストを送信できるようになります。

GET リクエストの送信
cURL を使用した GET リクエストの送信は非常に簡単です。まず、以下に示すように、cURL リソースを初期化し、curl_setopt() 関数を使用して対応するオプションを設定する必要があります。

$url = 'https://api.example.com/data';
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

上記のコードでは、最初にリモート API の URL を定義し、curl_init を使用します。 () 関数 cURL リソースを初期化します。次に、CURLOPT_URL オプションをリモート API の URL に設定し、CURLOPT_RETURNTRANSFER オプションを true に設定して、curl_exec() 関数を通じてリモート API の応答コンテンツを返すことを示します。最後に、curl_close() 関数を使用して cURL リソースを閉じます。

POST リクエストの送信
cURL を使用した POST リクエストの送信は、GET リクエストと似ています。cURL リソースを初期化した後に CURLOPT_POST オプションを true に設定し、CURLOPT_POSTFIELDS オプションを要求された値に設定するだけです。以下に示す POST データ :

$url = 'https://api.example.com/data';
$params = array('name' => 'John Doe', 'email' => 'johndoe@example.com');
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($params));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

上記のコードでは、最初にリモート API の URL と POST リクエストのパラメーターを定義します。次に、curl_init() 関数を使用して cURL リソースを初期化し、CURLOPT_URL オプションをリモート API の URL に設定し、CURLOPT_RETURNTRANSFER オプションを true に設定します。次に、CURLOPT_POST オプションを true に設定し、CURLOPT_POSTFIELDS オプションを定義した POST パラメーターに設定します。最後に、curl_exec() 関数を通じて POST リクエストを実行し、curl_close() 関数を使用して cURL リソースを閉じました。

HTTP ヘッダーを使用してリクエストを送信する
一部のシナリオでは、リクエストを送信するために HTTP ヘッダーをカスタマイズする必要があります。このとき、以下に示すように、CURLOPT_HTTPHEADER オプションを設定して HTTP ヘッダーを設定する必要があります。

$url = 'https://api.example.com/data';
$params = array('name' => 'John Doe', 'email' => 'johndoe@example.com');
$headers = array(
    'Authorization: Bearer ' . $token,
    'Content-Type: application/x-www-form-urlencoded'
);
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

上記のコードでは、最初にリモート API の URL と POST リクエストのパラメーターを定義します。次に、HTTP ヘッダーの配列を定義し、Authorization と Content-Type という 2 つの HTTP ヘッダーを設定します。最後に、curl_setopt() 関数を使用して CURLOPT_HTTPHEADER オプションを定義された HTTP ヘッダー配列に設定し、それによって送信する HTTP ヘッダーを指定します。

概要
cURL を使用してリモート API 呼び出しを行うことは、PHP 開発では非常に一般的な手法です。この記事では、cURL を使用して GET、POST リクエストを送信する方法と、HTTP ヘッダーを使用してリクエストを送信する方法を紹介しました。もちろん、実際のアプリケーションでは、詳細を理解して適用する必要がある他のオプションやアプリケーション シナリオが多数あります。この記事が初心者にとって有益であり、良い出発点となることを願っています。

以上がPHP で cURL を使用してリモート API 呼び出しを行う方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。