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

Copy
1<?php
2
3/**
4 * 指定されたURLに対して、最大TLSv1.2プロトコルを使用するよう制限して
5 * HTTP (HTTPS) GETリクエストを実行します。
6 *
7 * この関数は、CURL_SSLVERSION_MAX_TLSv1_2 定数を使用して
8 * cURLリクエストのSSL/TLSバージョン設定を行います。
9 * これは、より新しいTLSバージョン (例: TLSv1.3) の使用を避けたい場合に有用です。
10 *
11 * @param string $url リクエストを送信するターゲットURL (HTTPSを推奨)。
12 * @return string|false リクエストが成功した場合はレスポンス本文、
13 *                      失敗した場合は false を返します。
14 */
15function fetchDataWithMaxTlsV1_2(string $url): string|false
16{
17    // cURLセッションを初期化
18    $ch = curl_init();
19
20    if ($ch === false) {
21        // cURLの初期化に失敗した場合
22        return false;
23    }
24
25    // リクエストURLを設定
26    curl_setopt($ch, CURLOPT_URL, $url);
27
28    // サーバーからのレスポンスを文字列として取得するように設定
29    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
30
31    // SSL証明書の検証を有効にする（セキュリティのために推奨）
32    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
33    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // ホスト名の検証を有効にする
34
35    // ★ CURL_SSLVERSION_MAX_TLSv1_2 定数を使用して、
36    // ★ SSL/TLSプロトコルの最大バージョンをTLSv1.2に制限します。
37    // ★ これにより、TLSv1.3などの新しいバージョンは使用されなくなります。
38    // ★ 許可されるのはTLSv1.0, TLSv1.1, TLSv1.2です。
39    curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_MAX_TLSv1_2);
40
41    // cURLリクエストを実行し、レスポンスを取得
42    $response = curl_exec($ch);
43
44    // cURLセッションを閉じる
45    curl_close($ch);
46
47    return $response;
48}
49
50// --- サンプルコードの利用例 ---
51// 実際に存在するHTTPSサイトのURLを指定してください。
52// 例: Googleのホームページ
53$targetUrl = 'https://www.google.com';
54
55echo "{$targetUrl} へのHTTPSリクエストを開始します...\n";
56
57// 関数を呼び出し、レスポンスを取得
58$content = fetchDataWithMaxTlsV1_2($targetUrl);
59
60if ($content !== false) {
61    echo "リクエスト成功。取得したコンテンツの最初の200文字:\n";
62    // 取得したコンテンツが非常に長い場合があるので、最初の部分のみ表示
63    echo substr($content, 0, 200) . "...\n";
64} else {
65    echo "リクエスト失敗。コンテンツを取得できませんでした。\n";
66    echo "cURL拡張機能が有効になっているか、またはURLが正しいか確認してください。\n";
67}

このサンプルコードは、PHPのcURLライブラリを利用して、指定されたURLへHTTPまたはHTTPSのGETリクエストを送信する機能を実装しています。特に、SSL/TLSプロトコルのバージョンを制限する設定が特徴です。

fetchDataWithMaxTlsV1_2関数は、リクエストを送信するターゲットURLを示す文字列$urlを引数として受け取ります。この関数はcURLセッションを初期化し、CURLOPT_URLオプションでターゲットURLを設定後、CURLOPT_RETURNTRANSFERオプションでサーバーからのレスポンスを文字列として取得するように設定します。

このコードの核心は、curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_MAX_TLSv1_2);という行にあります。ここで使用されているCURL_SSLVERSION_MAX_TLSv1_2定数は、cURLがSSL/TLS通信を行う際に使用するプロトコルの最大バージョンをTLSv1.2に制限します。これにより、TLSv1.3のようなより新しいバージョンのプロトコルが利用可能なサーバーであっても、TLSv1.2、TLSv1.1、またはTLSv1.0のみが通信に使用されるようになります。これは、特定の古いシステムとの互換性を確保する必要がある場合や、意図的に新しいTLSバージョンの使用を避けたい場合に有用な設定です。

リクエストが正常に完了した場合、関数はサーバーから取得したレスポンス本文を文字列として返します。もしcURLセッションの初期化に失敗したり、リクエストの実行中にエラーが発生したりした場合は、falseを戻り値として返します。この仕組みにより、安全かつ特定のプロトコルバージョンに制限されたネットワーク通信をプログラムで実現できます。

Copy
1<?php
2
3/**
4 * CURL_SSLVERSION_MAX_TLSv1_2 定数を使用して、CURLが使用するSSL/TLSプロトコルの
5 * 最大バージョンをTLSv1.2に制限してHTTPSリクエストを実行するサンプルです。
6 *
7 * システムエンジニアを目指す初心者向けに、CURLの基本的な使い方と
8 * 特定のSSL/TLSバージョンを指定する方法を示します。
9 *
10 * @param string $url 取得するURL（HTTPSである必要があります）。
11 * @return string|null 取得したコンテンツ。エラー時はnull。
12 */
13function fetchSecureUrlWithTls1_2Max(string $url): ?string
14{
15    // CURLセッションを初期化します。
16    $ch = curl_init();
17
18    if ($ch === false) {
19        // CURLの初期化に失敗した場合のエラーメッセージ
20        echo "エラー: CURLの初期化に失敗しました。\n";
21        return null;
22    }
23
24    // 取得するターゲットURLを設定します。
25    curl_setopt($ch, CURLOPT_URL, $url);
26
27    // CURLリクエストの実行結果を文字列として返すように設定します。
28    // trueに設定しない場合、結果が直接出力されます。
29    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
30
31    // CURLOPT_SSLVERSION オプションに CURL_SSLVERSION_MAX_TLSv1_2 を設定します。
32    // これにより、CURLはSSL/TLSプロトコルの最大バージョンをTLSv1.2に制限します。
33    // 例えば、この設定ではTLSv1.3は使用されず、TLSv1.2、TLSv1.1、TLSv1.0が利用可能な場合、
34    // サーバーがサポートする最も高いバージョン（最大TLSv1.2）が選択されます。
35    curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_MAX_TLSv1_2);
36
37    // CURLリクエストを実行し、サーバーからのレスポンスを取得します。
38    $response = curl_exec($ch);
39
40    // CURLリクエスト中にエラーが発生したかを確認します。
41    if (curl_errno($ch)) {
42        // エラーが発生した場合、エラーメッセージを表示します。
43        echo 'CURLエラー (' . curl_errno($ch) . '): ' . curl_error($ch) . "\n";
44        $response = null; // エラー時は結果をnullに設定します。
45    }
46
47    // CURLセッションを閉じ、関連するリソースを解放します。
48    curl_close($ch);
49
50    return $response;
51}
52
53// この関数を使用する例:
54// 実際のHTTPS URLを指定してください。
55$targetUrl = 'https://www.php.net/'; 
56
57echo "URL: " . $targetUrl . " からのコンテンツ取得をTLSv1.2までのバージョンで試行中...\n";
58
59// 関数を呼び出し、コンテンツを取得します。
60$content = fetchSecureUrlWithTls1_2Max($targetUrl);
61
62if ($content !== null) {
63    echo "コンテンツの取得に成功しました。最初の500文字を表示:\n";
64    // 取得したコンテンツの最初の500文字を表示します。
65    echo substr($content, 0, 500) . "...\n";
66} else {
67    echo "コンテンツの取得に失敗しました。\n";
68}

PHPのCURL_SSLVERSION_MAX_TLSv1_2定数は、CURL拡張機能を使用してHTTPS通信を行う際に、SSL/TLSプロトコルの最大バージョンをTLSv1.2に制限するために用いられます。この定数をCURLOPT_SSLVERSIONオプションに設定することで、CURLはTLSv1.3などの新しいプロトコルバージョンを使用せず、TLSv1.2またはそれより古い互換性のあるバージョンの中から、サーバーがサポートする最も高いバージョンを選択するようになります。これは、特定のセキュリティ要件を満たす必要がある場合や、古いシステムとの互換性を確保したい場合に活用できます。

提供されたサンプルコードは、この定数を用いてHTTPSリクエストを実行する具体的な例です。fetchSecureUrlWithTls1_2Max関数は、引数として指定された$url（HTTPS形式）からウェブコンテンツを取得します。関数内では、まずcurl_init()でCURLセッションを初期化し、curl_setopt()関数で、取得するURL、応答を文字列で返す設定を行います。特に、CURLOPT_SSLVERSIONオプションにCURL_SSLVERSION_MAX_TLSv1_2を設定することで、TLSv1.2がSSL/TLSプロトコルの上限として適用されます。リクエストはcurl_exec()で実行され、取得したコンテンツが文字列として返されます。処理中にエラーが発生した場合はcurl_errno()で確認し、エラーメッセージを表示した後にnullを戻り値として返します。成功した場合は取得したコンテンツの文字列を返します。最後にcurl_close()でリソースを解放します。このコードは、CURLの基本的な使い方と、特定のSSL/TLSバージョンを指定する重要性を学ぶ上で役立ちます。