【PHP8.x】CURLOPT_HTTP_VERSION定数の使い方

Copy
1<?php
2
3/**
4 * 指定されたHTTPバージョンでcURLリクエストを実行します。
5 * システムエンジニアを目指す初心者向けに、CURLOPT_HTTP_VERSIONの基本的な使い方を示します。
6 *
7 * @param string $url リクエストを送信するURL。
8 * @param int $httpVersion 使用するHTTPバージョン定数 (例: CURL_HTTP_VERSION_1_1, CURL_HTTP_VERSION_2_0)。
9 * @return string リクエストの結果、またはエラーメッセージ。
10 */
11function performCurlRequestWithHttpVersion(string $url, int $httpVersion): string
12{
13    // cURLセッションを初期化します。
14    $ch = curl_init();
15
16    if ($ch === false) {
17        return "cURLの初期化に失敗しました。";
18    }
19
20    // リクエスト対象のURLを設定します。
21    curl_setopt($ch, CURLOPT_URL, $url);
22
23    // 戻り値を文字列として取得するように設定します。
24    // これをtrueにすると、curl_exec()が成功時に結果を文字列で返します。
25    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
26
27    // ここで CURLOPT_HTTP_VERSION を設定します。
28    // これにより、cURLが指定されたHTTPプロトコルバージョンを使用してリクエストを送信します。
29    //
30    // 主な値:
31    // - CURL_HTTP_VERSION_1_0: HTTP/1.0 を使用します。
32    // - CURL_HTTP_VERSION_1_1: HTTP/1.1 を使用します (最も一般的です)。
33    // - CURL_HTTP_VERSION_2_0: HTTP/2 を使用します (サーバーが対応している場合)。
34    // - CURL_HTTP_VERSION_NONE: cURLに最適なバージョンを選択させます (デフォルト動作)。
35    curl_setopt($ch, CURLOPT_HTTP_VERSION, $httpVersion);
36
37    // cURLリクエストを実行し、結果を取得します。
38    $response = curl_exec($ch);
39
40    // エラーが発生した場合は、エラーメッセージを返します。
41    if (curl_errno($ch)) {
42        $errorMsg = curl_error($ch);
43        curl_close($ch); // エラー時でもセッションを閉じます。
44        return "cURLエラー: " . $errorMsg;
45    }
46
47    // cURLセッションを閉じ、リソースを解放します。
48    curl_close($ch);
49
50    return $response;
51}
52
53// --- サンプルコードの実行例 ---
54
55// テスト用のURLを設定 (HTTP/1.1をサポートする一般的なサイト)
56$urlToTest = "http://example.com";
57// CURL_HTTP_VERSION_1_1 を使用してHTTP/1.1プロトコルを指定
58$httpVersionToUse = CURL_HTTP_VERSION_1_1;
59
60echo "{$urlToTest} に HTTP/1.1 を使用してリクエストを送信中...\n";
61
62// 関数を呼び出し、結果を取得
63$result = performCurlRequestWithHttpVersion($urlToTest, $httpVersionToUse);
64
65// 結果を表示
66if (strpos($result, "cURLエラー") === 0) {
67    echo $result . "\n";
68} else {
69    echo "成功！レスポンスの最初の500文字:\n";
70    // 取得したレスポンスが長すぎる場合を考慮し、最初の部分のみ表示します。
71    echo substr($result, 0, 500) . "...\n";
72}
73
74// 参考: HTTP/2を試す場合 (対応するURLと適切なSSL/TLS設定が必要です)
75// $urlToTestHttp2 = "https://www.google.com"; // HTTP/2対応サイトの例
76// $httpVersionToUseHttp2 = CURL_HTTP_VERSION_2_0; // HTTP/2 を指定
77//
78// echo "\n{$urlToTestHttp2} に HTTP/2 を使用してリクエストを送信中...\n";
79// $resultHttp2 = performCurlRequestWithHttpVersion($urlToTestHttp2, $httpVersionToUseHttp2);
80// if (strpos($resultHttp2, "cURLエラー") === 0) {
81//     echo $resultHttp2 . "\n";
82// } else {
83//     echo "成功！HTTP/2 レスポンスの最初の500文字:\n";
84//     echo substr($resultHttp2, 0, 500) . "...\n";
85// }

このPHPのサンプルコードは、CURLOPT_HTTP_VERSIONオプションを利用して、HTTPリクエストで使用するプロトコルバージョンを明示的に指定する方法をシステムエンジニアを目指す初心者にも分かりやすく説明しています。

performCurlRequestWithHttpVersion関数は、引数として指定された$url（リクエストを送信するURL）と$httpVersion（使用するHTTPバージョン定数）を受け取り、cURLリクエストを実行します。関数内では、まずcurl_init()でcURLセッションを初期化し、CURLOPT_URLでリクエスト対象のURLを設定します。CURLOPT_RETURNTRANSFERオプションをtrueに設定することで、リクエストの実行結果を文字列として取得できるようにしています。

最も重要な部分として、CURLOPT_HTTP_VERSIONオプションを設定します。ここでは$httpVersion引数で渡された定数（例: CURL_HTTP_VERSION_1_1はHTTP/1.1、CURL_HTTP_VERSION_2_0はHTTP/2）を指定し、cURLがそのHTTPプロトコルバージョンを使ってサーバーと通信するように指示します。CURL_HTTP_VERSION_NONEを指定すると、cURLが最適なバージョンを自動で選択します。

設定後、curl_exec()でcURLリクエストを実行し、その結果を取得します。リクエスト中にエラーが発生した場合はcurl_errno()で検出し、エラーメッセージを返します。成功した場合は、サーバーからのレスポンス内容が文字列として関数の戻り値になります。最後にcurl_close()でセッションを閉じ、リソースを適切に解放しています。この一連の処理により、HTTPプロトコルバージョンを細かく制御したウェブ通信が可能です。