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

Copy
1<?php
2
3/**
4 * CURL_HTTP_VERSION_2TLS 定数を使用して、HTTP/2 over TLS でCURLリクエストを実行する例。
5 *
6 * この関数は、指定されたURLに対してCURLリクエストを行い、
7 * PHP 8 で利用可能なCURL_HTTP_VERSION_2TLS 定数を使ってHTTP/2プロトコルの使用を試みます。
8 * CURL_HTTP_VERSION_2TLS は、CURLがTLSv1.2以降のバージョンでHTTP/2をネゴシエートするよう指示する定数です。
9 *
10 * @param string $url リクエストを送信するURL。
11 * @return string|false リクエストのレスポンスボディ、またはエラーが発生した場合はfalse。
12 */
13function makeCurlRequestWithHttp2Tls(string $url): string|false
14{
15    // cURLセッションを初期化します。
16    $ch = curl_init();
17
18    // 初期化に失敗した場合はエラーを記録し、falseを返します。
19    if ($ch === false) {
20        error_log("cURLセッションの初期化に失敗しました。PHPのcURL拡張機能が有効になっているか確認してください。");
21        return false;
22    }
23
24    // cURLオプションを設定します。
25    // リクエスト先のURLを指定します。
26    curl_setopt($ch, CURLOPT_URL, $url);
27    // サーバーからのレスポンスを文字列として取得するように設定します（画面に直接出力しない）。
28    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
29    // リクエストの最大実行時間を10秒に設定します。
30    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
31    // ここがCURL_HTTP_VERSION_2TLSの主要な使用箇所です。
32    // cURLにTLSv1.2以降のバージョンでHTTP/2プロトコルをネゴシエートするよう指示します。
33    curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2TLS);
34
35    // cURLリクエストを実行し、結果を取得します。
36    $response = curl_exec($ch);
37
38    // cURLリクエスト中にエラーが発生したか確認します。
39    if (curl_errno($ch)) {
40        $error_msg = curl_error($ch);
41        error_log("cURLリクエストエラーが発生しました: " . $error_msg);
42        $response = false; // エラーがあった場合はレスポンスをfalseとします。
43    } else {
44        // リクエストが成功した場合、HTTPステータスコードを取得します。
45        $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
46        // HTTPステータスコードが400以上（クライアントエラーまたはサーバーエラー）の場合、エラーとして扱います。
47        if ($http_code >= 400) {
48            error_log("HTTPリクエストが失敗しました。ステータスコード: " . $http_code);
49            // 必要であれば、ここでさらに詳細なエラー処理を行うことも可能です。
50        }
51    }
52
53    // cURLセッションを閉じ、リソースを解放します。
54    curl_close($ch);
55
56    return $response;
57}
58
59// スクリプトの実行部分
60// HTTP/2をサポートしている一般的なウェブサイトのURLを指定します。
61$targetUrl = 'https://www.google.com/';
62
63// ユーザーへの情報表示
64echo "指定されたURL (" . $targetUrl . ") へ、CURL_HTTP_VERSION_2TLS を使用してHTTP/2リクエストを試みます。\n";
65echo "この定数は、CURLにTLSv1.2以降のバージョンでHTTP/2プロトコルをネゴシエートするよう指示します。\n\n";
66
67// 関数を呼び出し、リクエストを実行します。
68$result = makeCurlRequestWithHttp2Tls($targetUrl);
69
70// 結果に基づいてユーザーにメッセージを表示します。
71if ($result !== false) {
72    echo "CURLリクエストは成功しました。\n";
73    echo "受信したレスポンスの一部:\n";
74    // 取得したレスポンスの最初の500文字のみを表示し、残りは省略します。
75    echo substr($result, 0, 500) . "...\n";
76    echo "\n(完全なレスポンスは表示されていません。)\n";
77} else {
78    echo "CURLリクエストが失敗しました。エラーログを確認してください。\n";
79}

PHP 8のCURL拡張機能に属する定数CURL_HTTP_VERSION_2TLSは、CURLリクエストをHTTP/2プロトコルで、かつTLSv1.2以降の安全な接続を使用して行うよう指定する際に利用されます。この定数は整数型（int）の値を持ちます。

サンプルコードのmakeCurlRequestWithHttp2Tls関数は、この定数を用いてHTTP/2 over TLSでのWebリクエストを実行する例です。この関数は、リクエスト先のURLを示す文字列型の引数$urlを受け取ります。関数内部では、まずcurl_initでCURLセッションを初期化し、各種オプションを設定します。特にcurl_setopt関数でCURLOPT_HTTP_VERSIONオプションにCURL_HTTP_VERSION_2TLSを指定することで、CURLがTLSv1.2以降のバージョンでHTTP/2プロトコルをネゴシエートするよう設定されます。

リクエストはcurl_execによって実行され、結果は変数$responseに格納されます。関数の戻り値はstring|false型で、リクエストが成功した場合はレスポンスボディが文字列として返されます。一方、CURLセッションの初期化失敗、リクエスト中のエラー、またはHTTPステータスコードが400以上の場合にはfalseが返されます。これにより、開発者はHTTP/2の利点を活用しつつ、安全な通信プロトコルでのデータ取得をPHPで行うことができます。

Copy
1<?php
2
3/**
4 * 指定されたURLに対し、HTTP/2 over TLS を優先してcURLリクエストを実行します。
5 *
6 * システムエンジニアを目指す初心者向けに、`CURL_HTTP_VERSION_2TLS` 定数の使い方と
7 * その結果ネゴシエートされたHTTPバージョンを確認する方法を示します。
8 * `CURL_HTTP_VERSION_2TLS` は、cURL が可能であれば HTTP/2 を TLS 上で使用するよう
9 * 試みるためのオプションです。
10 *
11 * @param string $url リクエストを送信するURL。HTTPSである必要があります。
12 * @return void
13 */
14function perform_curl_request_with_http2_tls(string $url): void
15{
16    // 1. cURL セッションを初期化します。
17    $ch = curl_init();
18
19    // cURL の初期化に失敗した場合の処理。
20    if ($ch === false) {
21        echo 'エラー: cURL の初期化に失敗しました。';
22        return;
23    }
24
25    // 2. リクエスト先のURLを設定します。
26    curl_setopt($ch, CURLOPT_URL, $url);
27
28    // 3. サーバーからの応答を直接出力せず、文字列として取得するよう設定します。
29    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
30
31    // 4. HTTP/2 over TLS (Transport Layer Security) を優先的に使用するよう設定します。
32    //    `CURL_HTTP_VERSION_2TLS` は、cURL が安全な通信チャネル（TLS）上で、
33    //    より新しいHTTP/2プロトコルを使用しようと試みることを指示します。
34    //    サーバーがHTTP/2をサポートしない場合は、HTTP/1.1などに自動的にフォールバックします。
35    curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2TLS);
36
37    // 5. サーバー証明書の検証を有効にします。本番環境では常に有効にすべき重要な設定です。
38    //    これにより、通信相手が信頼できるサーバーであることを確認します。
39    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true); // ピアの証明書を検証
40    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);   // ホスト名が証明書と一致するか検証 (PHP 5.6以降は推奨値)
41
42    // 6. cURL リクエストを実行し、サーバーからの応答を取得します。
43    $response = curl_exec($ch);
44
45    // 7. cURL の実行中にエラーが発生したか確認します。
46    if (curl_errno($ch)) {
47        echo 'cURL エラー (' . curl_errno($ch) . '): ' . curl_error($ch) . "\n";
48    } else {
49        // 8. リクエストが成功した場合、ネゴシエートされたHTTPバージョン情報を取得します。
50        //    これにより、`CURL_HTTP_VERSION_2TLS` の設定がどのように反映されたかを
51        //    間接的に確認できます（例: HTTP/2が使用されたか）。
52        $http_version_code = curl_getinfo($ch, CURLINFO_HTTP_VERSION);
53
54        // 取得したHTTPバージョンコードを人間が読める形式に変換します。
55        $negotiated_version_str = match ($http_version_code) {
56            CURL_HTTP_VERSION_1_0 => 'HTTP/1.0',
57            CURL_HTTP_VERSION_1_1 => 'HTTP/1.1',
58            CURL_HTTP_VERSION_2_0 => 'HTTP/2',
59            CURL_HTTP_VERSION_3 => 'HTTP/3', // PHP 8.1+ と対応するcURLライブラリでサポートされる可能性
60            default => '不明なバージョン (' . $http_version_code . ')',
61        };
62
63        echo "リクエストURL: " . $url . "\n";
64        echo "ネゴシエートされたHTTPバージョン: " . $negotiated_version_str . "\n";
65        echo "レスポンスの最初の100文字:\n";
66        echo substr((string)$response, 0, 100) . "...\n";
67    }
68
69    // 9. cURL セッションを終了し、使用したリソースを解放します。
70    curl_close($ch);
71}
72
73// サンプルコードを実行します。
74// HTTP/2 over TLS をサポートする一般的な公開ウェブサイト（例: Google）を使用します。
75// これにより、HTTP/2がネゴシエートされる可能性が高いです。
76perform_curl_request_with_http2_tls('https://www.google.com');
77

PHPの定数CURL_HTTP_VERSION_2TLSは、cURLライブラリを用いてウェブサイトへHTTPリクエストを送信する際、通信プロトコルとしてHTTP/2 over TLS（Transport Layer Security）を優先的に利用するよう指示するための設定値です。これは、より高速で効率的な通信が可能なHTTP/2プロトコルを、データを暗号化して保護する安全な通信経路であるTLS上で確立しようと試みるためのものです。

この定数は、curl_setopt関数の第二引数にCURLOPT_HTTP_VERSIONを指定し、第三引数にこのCURL_HTTP_VERSION_2TLSを設定して使用します。例えば、curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2TLS);のように記述することで、cURLは接続先のサーバーがHTTP/2に対応していれば、そのプロトコルを選択して通信を行います。もしサーバーがHTTP/2に対応していない場合でも、自動的にHTTP/1.1などの利用可能なプロトコルへ切り替わるため、通信が失敗することはありません。

この定数自体には引数はなく、その値は整数型（int）で定義されています。そのため、特定の関数がこの定数を呼び出した際に戻り値を返すというような挙動はありません。リクエスト完了後には、curl_getinfo関数とCURLINFO_HTTP_VERSIONオプションを使用することで、実際にサーバーとの間でどのHTTPバージョンがネゴシエートされたかを確認することが可能です。この設定は、最新のWebプロトコルを活用して通信のパフォーマンスとセキュリティを向上させたい場合に有効です。