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

Copy
1<?php
2
3/**
4 * CURL_HTTP_VERSION_2_0 定数を使用してHTTP/2.0でGETリクエストを実行するサンプル関数。
5 *
6 * この関数は、指定されたURLに対してcURLを使用してHTTP GETリクエストを送信します。
7 * CURL_HTTP_VERSION_2_0 定数を CURLOPT_HTTP_VERSION オプションに設定することで、
8 * HTTP/2.0プロトコルを優先的に使用するようにcURLに指示します。
9 *
10 * @param string $url リクエストを送信するターゲットURL。
11 * @return string|false リクエストが成功した場合はレスポンス本文、失敗した場合は false。
12 */
13function performCurlHttp2GetRequest(string $url): string|false
14{
15    // 1. cURLセッションを初期化します。
16    // curl_init() は新しいcURLセッションを初期化し、cURLハンドルを返します。
17    $ch = curl_init();
18
19    // 初期化に失敗した場合のチェック
20    if ($ch === false) {
21        error_log("Error: cURL could not be initialized.");
22        return false;
23    }
24
25    // 2. cURLオプションを設定します。
26    // CURLOPT_URL: リクエストを送信するURL。
27    curl_setopt($ch, CURLOPT_URL, $url);
28
29    // CURLOPT_RETURNTRANSFER: curl_exec() が結果を文字列として返すようにします。
30    // false の場合、結果は直接出力されます。
31    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
32
33    // CURLOPT_HEADER: レスポンスヘッダを含めるかどうか。false に設定すると、ボディのみが返されます。
34    curl_setopt($ch, CURLOPT_HEADER, false);
35
36    // ここで CURL_HTTP_VERSION_2_0 定数を使用します。
37    // CURLOPT_HTTP_VERSION: 使用するHTTPプロトコルバージョンを設定します。
38    // CURL_HTTP_VERSION_2_0 は HTTP/2.0 を要求する定数です。
39    // ただし、cURLライブラリがHTTP/2.0をサポートしていない場合、またはサーバーがHTTP/2.0をサポートしていない場合は、
40    // cURLは自動的に古いバージョン（HTTP/1.1など）にフォールバックすることがあります。
41    curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2_0);
42
43    // (開発/テスト用注意) SSL証明書の検証を無効にするオプション。
44    // 本番環境ではセキュリティのため、通常は有効 (true) にしておくべきです。
45    // サンプルコードを簡単に実行できるようにするため、今回は無効にしています。
46    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
47    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
48
49
50    // 3. cURLセッションを実行し、レスポンスを取得します。
51    // curl_exec() は、設定されたオプションに基づいてリクエストを実行します。
52    $response = curl_exec($ch);
53
54    // 4. エラーチェックを行います。
55    // curl_errno() は直前のcURL操作のエラー番号を返します。エラーがない場合は 0 を返します。
56    if (curl_errno($ch)) {
57        error_log('cURL Error: ' . curl_error($ch)); // エラーメッセージをログに記録
58        $response = false; // エラー発生時は false を返す
59    }
60
61    // 5. cURLセッションを閉じ、リソースを解放します。
62    curl_close($ch);
63
64    return $response;
65}
66
67// 関数の使用例:
68// 実際のHTTP/2.0対応サイト（例：Google）を指定してテストします。
69$targetUrl = 'https://www.google.com/';
70
71echo "Attempting to fetch {$targetUrl} using HTTP/2.0...\n";
72
73// 関数を呼び出し、結果を取得
74$result = performCurlHttp2GetRequest($targetUrl);
75
76if ($result !== false) {
77    echo "Request successful. Displaying first 500 characters of the response:\n";
78    // レスポンスが長すぎる場合を考慮し、最初の500文字のみ表示します。
79    echo substr($result, 0, 500) . "...\n";
80    // さらに、実際に使用されたHTTPバージョンを取得してみます。
81    // $info = curl_getinfo($ch, CURLINFO_HTTP_VERSION); // $ch が関数スコープ外なのでここでは取得できないが、参考情報
82    // echo "Actual HTTP Version used: " . ($info == 2 ? "HTTP/2" : ($info == 1 ? "HTTP/1.1" : "Unknown")) . "\n";
83} else {
84    echo "Request failed. Please check the URL and cURL extension.\n";
85}
86

このPHPサンプルコードは、CURL_HTTP_VERSION_2_0定数を用いて、指定されたURLへHTTP/2.0プロトコルでGETリクエストを送信する関数performCurlHttp2GetRequestを示しています。

関数内では、まずcurl_init()で新しいcURLセッションを開始し、curl_setopt()関数で各種オプションを設定します。特に重要なのは、CURLOPT_HTTP_VERSIONオプションにCURL_HTTP_VERSION_2_0定数を設定している点です。これにより、cURLはHTTP/2.0プロトコルでの通信を優先的に試みます。ただし、接続先のサーバーがHTTP/2.0をサポートしていない場合や、cURLライブラリの環境によっては、自動的にHTTP/1.1などの古いバージョンにフォールバックすることがあります。

CURLOPT_URLでリクエスト先のURLを指定し、CURLOPT_RETURNTRANSFERをtrueに設定することで、curl_exec()の実行結果が文字列として返されるようにしています。curl_exec()は実際にリクエストを送信し、サーバーからのレスポンス本文を取得します。処理中にエラーが発生した場合は、curl_errno()でエラー番号を確認し、エラーメッセージを記録します。最終的にcurl_close()でcURLセッションを閉じ、使用したリソースを解放します。

この関数は引数として$url（リクエストを送信するターゲットURL、文字列型）を受け取ります。戻り値は、リクエストが成功した場合はレスポンス本文（文字列型）、失敗した場合はfalseを返します。サンプルコードでは利便性のためSSL証明書の検証を無効にしていますが、本番環境ではセキュリティの観点から通常は有効にすべきです。

Copy
1<?php
2
3/**
4 * 指定されたURLに対してHTTP/2を使用するように設定してHTTPリクエストを送信します。
5 * 実際に使用されたHTTPバージョンとレスポンスの一部を返します。
6 *
7 * @param string $url リクエストを送信するURL。
8 * @return array|false 成功した場合は連想配列（'http_version', 'status_code', 'response_excerpt'）を返します。失敗した場合はfalse。
9 */
10function makeHttpRequestWithHttp2(string $url): array|false
11{
12    $ch = curl_init();
13
14    if ($ch === false) {
15        // cURLの初期化に失敗した場合
16        echo "エラー: cURLの初期化に失敗しました。\n";
17        return false;
18    }
19
20    // リクエスト先のURLを設定
21    curl_setopt($ch, CURLOPT_URL, $url);
22
23    // CURL_HTTP_VERSION_2_0 定数を使用して、cURLがHTTP/2を優先的に使用するよう設定します。
24    // サーバーがHTTP/2をサポートしている場合、HTTP/2での通信が試みられます。
25    curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2_0);
26
27    // レスポンスを文字列として取得するように設定
28    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
29
30    // SSL証明書の検証を有効にする（HTTPSサイトの場合に推奨）
31    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
32    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
33
34    // HTTPリクエストを実行し、レスポンスボディを取得
35    $response_body = curl_exec($ch);
36
37    // エラーチェック
38    if (curl_errno($ch)) {
39        $error_msg = curl_error($ch);
40        echo "cURLエラー: " . $error_msg . "\n";
41        curl_close($ch);
42        return false;
43    }
44
45    // 実際に使用されたHTTPバージョンを取得
46    // CURLINFO_HTTP_VERSIONは、実際に通信で使用されたHTTPプロトコルのバージョンを返します。
47    // CURLOPT_HTTP_VERSIONにCURL_HTTP_VERSION_2_0を設定してHTTP/2が成功した場合、
48    // 通常CURL_HTTP_VERSION_2TLS（HTTPSの場合）などが返されます。
49    $http_version_code = curl_getinfo($ch, CURLINFO_HTTP_VERSION);
50    $http_version_map = [
51        CURL_HTTP_VERSION_NONE => '未指定',
52        CURL_HTTP_VERSION_1_0 => 'HTTP/1.0',
53        CURL_HTTP_VERSION_1_1 => 'HTTP/1.1',
54        CURL_HTTP_VERSION_2TLS => 'HTTP/2 (TLS)',
55        CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE => 'HTTP/2 (Prior Knowledge)',
56        CURL_HTTP_VERSION_3 => 'HTTP/3',
57    ];
58    $display_http_version = $http_version_map[$http_version_code] ?? '不明 (' . $http_version_code . ')';
59
60    // HTTPステータスコードを取得
61    $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
62
63    // cURLセッションを閉じる
64    curl_close($ch);
65
66    // レスポンスボディの一部を抜粋して表示用に準備
67    $response_excerpt = substr($response_body, 0, 500) . (strlen($response_body) > 500 ? '...' : '');
68
69    return [
70        'http_version' => $display_http_version,
71        'status_code' => $status_code,
72        'response_excerpt' => $response_excerpt,
73    ];
74}
75
76// --- サンプルコードの実行 ---
77
78// HTTP/2をサポートしているウェブサイトのURLを指定します
79$target_url = "https://www.google.com/";
80
81echo "URL: " . $target_url . " に対してHTTP/2を使用する設定でリクエストを送信します。\n";
82echo "※サーバーがHTTP/2をサポートしていない場合、またはネゴシエーションが失敗した場合は、\n";
83echo "  HTTP/1.1などの他のプロトコルにフォールバックされることがあります。\n\n";
84
85$result = makeHttpRequestWithHttp2($target_url);
86
87if ($result !== false) {
88    echo "--- リクエスト結果 ---\n";
89    echo "実際に使用されたHTTPバージョン: " . $result['http_version'] . "\n";
90    echo "HTTPステータスコード: " . $result['status_code'] . "\n";
91    echo "レスポンスボディの抜粋 (最初の500文字):\n";
92    echo $result['response_excerpt'] . "\n";
93} else {
94    echo "HTTPリクエストの実行に失敗しました。\n";
95}

PHPのCURL_HTTP_VERSION_2_0は、HTTPリクエストを送信する際に、HTTP/2プロトコルを優先的に使用するようPHPのcURL拡張機能に指示するための定数です。この定数自体に引数や戻り値はなく、特定の数値を表し、cURLの設定オプションとして利用されます。

サンプルコードでは、makeHttpRequestWithHttp2関数が指定されたURLに対してHTTPリクエストを送信する際に、このCURL_HTTP_VERSION_2_0定数をcurl_setopt関数のCURLOPT_HTTP_VERSIONオプションに設定しています。これにより、cURLは対象のウェブサーバーがHTTP/2をサポートしている場合、HTTP/2での通信を試みます。HTTP/2は、従来のHTTP/1.1に比べてパフォーマンスが向上しており、現代のウェブアプリケーションでは推奨されるプロトコルです。

ただし、この設定を行ったとしても、接続先のサーバーがHTTP/2に対応していない場合や、何らかの理由でHTTP/2でのネゴシエーションが失敗した場合は、自動的にHTTP/1.1などの他のプロトコルに切り替わって通信が行われることがあります。

関数は、リクエストの結果として、実際に使用されたHTTPバージョン、サーバーから返されたHTTPステータスコード、およびレスポンスボディの一部を連想配列として返します。これにより、設定したHTTP/2プロトコルが実際に適用されたかどうかを確認することができます。CURL_HTTP_VERSION_2_0は、PHPでより効率的なHTTP通信を実現するために重要な定数です。