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

Copy
1<?php
2
3/**
4 * TLSv1.3プロトコルを使用してリモートサーバーへの暗号化された接続を確立する方法を示します。
5 *
6 * この関数は、最初に生のTCPソケットを確立し、次に
7 * stream_socket_enable_crypto() を使用してTLSv1.3暗号化を適用します。
8 * これは、STREAM_CRYPTO_PROTO_TLSv1_3 定数の使用例となります。
9 *
10 * システムエンジニアを目指す初心者向けに、ソケット通信と暗号化の基本を示します。
11 */
12function demonstrateTls13ClientConnection(): void
13{
14    // 接続先のホストとポートを指定
15    $host = 'www.example.com';
16    $port = 443; // 標準的なHTTPSポート
17
18    $errno = null; // エラー番号を格納する変数
19    $errstr = null; // エラーメッセージを格納する変数
20
21    echo "{$host}:{$port} への接続を試行中...\n";
22
23    // 1. 生のTCPソケットとして接続を確立
24    // stream_socket_client の第四引数でタイムアウトを設定します。
25    // ここでは暗号化を指定しないため、初期接続はプレーンなTCPです。
26    $socket = stream_socket_client("tcp://{$host}:{$port}", $errno, $errstr, 30);
27
28    if (!$socket) {
29        echo "エラー: 接続に失敗しました [{$errno}] {$errstr}\n";
30        return;
31    }
32
33    echo "{$host}:{$port} に生のTCPソケットとして接続しました。\n";
34
35    // 2. 接続済みのソケットに対してTLSv1.3による暗号化を有効化する
36    // stream_socket_enable_crypto() を使用して暗号化を適用します。
37    // - 第一引数: ソケットリソース
38    // - 第二引数 (true): 暗号化を有効にする
39    // - 第三引数 (STREAM_CRYPTO_CLIENT | STREAM_CRYPTO_PROTO_TLSv1_3):
40    //   クライアントとして接続し、TLSv1.3プロトコルを使用することを指定します。
41    //   STREAM_CRYPTO_PROTO_TLSv1_3 は、使用するTLSプロトコルバージョンを示します。
42    $cryptoType = STREAM_CRYPTO_CLIENT | STREAM_CRYPTO_PROTO_TLSv1_3;
43    $cryptoEnabled = stream_socket_enable_crypto(
44        $socket,
45        true,
46        $cryptoType
47    );
48
49    if ($cryptoEnabled === false) {
50        echo "エラー: TLSv1.3暗号化の有効化に失敗しました。\n";
51    } elseif ($cryptoEnabled === 0) {
52        // 暗号化ハンドシェイクがまだ完了していない場合。
53        // 実際のアプリケーションでは、ここでループして完了を待つか、非同期で処理します。
54        echo "TLSv1.3暗号化ハンドシェイクが進行中です。再試行してください。\n";
55    } else {
56        echo "ソケット上でTLSv1.3暗号化が正常に有効化されました。\n";
57
58        // 暗号化されたソケットを通じてHTTPリクエストを送信
59        $request = "GET / HTTP/1.1\r\nHost: {$host}\r\nConnection: Close\r\n\r\n";
60        fwrite($socket, $request);
61        echo "HTTP GET リクエストを送信しました。\n";
62
63        // 応答を読み込み、最初の500文字を表示
64        $response = '';
65        while (!feof($socket)) {
66            $response .= fgets($socket, 1024);
67        }
68        echo "受信した応答 (一部):\n";
69        echo substr($response, 0, 500) . (strlen($response) > 500 ? '...' : '') . "\n";
70    }
71
72    // ソケット接続を閉じる
73    fclose($socket);
74    echo "ソケットを閉じました。\n";
75}
76
77// 関数を実行してデモンストレーションを開始
78demonstrateTls13ClientConnection();

このPHPコードは、リモートサーバーとの安全な通信を確立するための手順を示しています。まず、stream_socket_client関数を使用して、指定されたホスト（www.example.com）のポート443へ、暗号化されていない生のTCPソケット接続を行います。これは、ウェブサイトへの通常の接続を想像すると分かりやすいでしょう。

接続が成功した後、stream_socket_enable_crypto関数を使って、このソケットに暗号化を適用します。ここで特に注目すべきは、STREAM_CRYPTO_PROTO_TLSv1_3という定数です。この定数はPHPの拡張機能の一部で、TLS（Transport Layer Security）プロトコルの最新バージョンであるTLSv1.3を使用して通信を暗号化することを指定します。STREAM_CRYPTO_PROTO_TLSv1_3は引数を取らず、整数値を返す定数であり、直接操作するものではなく、stream_socket_enable_crypto関数の第三引数に渡すことで、どのプロトコルを使うかをPHPに指示する役割を持ちます。

stream_socket_enable_crypto関数は、第一引数に確立済みのソケットリソース、第二引数に暗号化を有効にするかどうかの真偽値、第三引数に暗号化の種類とプロトコルバージョン（今回で言えばSTREAM_CRYPTO_PROTO_TLSv1_3を含む値）を指定します。この関数は、暗号化の確立に成功すればtrue、失敗すればfalse、暗号化のハンドシェイクが進行中の場合は0を返します。暗号化されたソケットが確立されると、安全な状態でHTTPリクエストを送信し、応答を受信することが可能になります。この一連のプロセスを通じて、インターネット上でのセキュアなデータ通信の仕組みを理解する基礎が得られます。

Copy
1<?php
2
3/**
4 * TLSv1.3 を使用して安全なクライアント接続を確立するサンプル関数です。
5 *
6 * PHP 8 以降で導入された STREAM_CRYPTO_PROTO_TLSv1_3 定数と
7 * STREAM_CRYPTO_METHOD_TLS_CLIENT を利用し、
8 * 指定されたホストとポートに TLSv1.3 で接続を試みます。
9 *
10 * @param string $host 接続先のホスト名 (例: 'www.example.com')
11 * @param int $port 接続先のポート番号 (通常は 443)
12 * @return string|false 成功した場合はサーバーからの応答、失敗した場合は false
13 */
14function connectTlsV1_3Client(string $host, int $port = 443)
15{
16    // ストリームコンテキストオプションを設定します。
17    // 'ssl' キーは SSL/TLS 関連の設定を定義します。
18    $contextOptions = [
19        'ssl' => [
20            // 最小プロトコルバージョンを STREAM_CRYPTO_PROTO_TLSv1_3 に設定します。
21            // これにより、TLSv1.3 以降のプロトコルでの接続を強制します。
22            'min_proto_version' => STREAM_CRYPTO_PROTO_TLSv1_3,
23
24            // 証明書検証を無効にします (開発/テスト目的でのみ推奨)。
25            // 本番環境ではセキュリティのため必ず有効にし、適切な CA 証明書を設定してください。
26            'verify_peer' => false,
27            'verify_peer_name' => false,
28            'allow_self_signed' => true,
29        ],
30    ];
31
32    // 設定したオプションでストリームコンテキストを作成します。
33    $streamContext = stream_context_create($contextOptions);
34
35    if (!$streamContext) {
36        echo "エラー: ストリームコンテキストの作成に失敗しました。\n";
37        return false;
38    }
39
40    // 指定されたホストとポートに TCP ソケット接続を試みます。
41    // 'tcp://' プレフィックスを使用し、TLS 暗号化は後で明示的に有効にします。
42    $socketAddress = "tcp://{$host}:{$port}";
43    $socket = @stream_socket_client(
44        $socketAddress,
45        $errno,
46        $errstr,
47        30, // 接続タイムアウトを30秒に設定
48        STREAM_CLIENT_CONNECT,
49        $streamContext // 作成したコンテキストをソケットに紐付けます
50    );
51
52    if (!$socket) {
53        echo "エラー: ソケット接続に失敗しました: ({$errno}) {$errstr}\n";
54        return false;
55    }
56
57    // ソケット上で TLS 暗号化を有効にします。
58    // STREAM_CRYPTO_METHOD_TLS_CLIENT はクライアントモードでの TLS 暗号化を指定します。
59    // この時点で、ストリームコンテキストで設定した TLSv1.3 の制約が適用されます。
60    if (!stream_socket_enable_crypto(
61        $socket,
62        true, // 暗号化を有効にする
63        STREAM_CRYPTO_METHOD_TLS_CLIENT
64    )) {
65        echo "エラー: TLS 暗号化の有効化に失敗しました。\n";
66        fclose($socket);
67        return false;
68    }
69
70    // 簡単な HTTP GET リクエストを送信します。
71    $request = "GET / HTTP/1.1\r\n";
72    $request .= "Host: {$host}\r\n";
73    $request .= "Connection: Close\r\n\r\n";
74    fwrite($socket, $request);
75
76    // サーバーからの応答をすべて読み取ります。
77    $response = '';
78    while (!feof($socket)) {
79        $response .= fread($socket, 8192); // 8KBずつ読み込み
80    }
81
82    // ソケット接続を閉じます。
83    fclose($socket);
84
85    return $response;
86}
87
88// --- 使用例 ---
89// TLSv1.3 をサポートしている可能性が高いホストを指定します。
90// 環境によっては接続できない場合もありますので、その場合は別のホストを試してください。
91$targetHost = 'www.google.com'; 
92
93echo "{$targetHost} に TLSv1.3 で接続を試みます...\n";
94$response = connectTlsV1_3Client($targetHost);
95
96if ($response !== false) {
97    echo "接続成功！\n";
98    echo "サーバー応答 (最初の500文字):\n";
99    // 応答は HTML の可能性があるので、エスケープして表示します
100    echo htmlspecialchars(substr($response, 0, 500)) . "...\n";
101} else {
102    echo "接続失敗。\n";
103}

このサンプルコードは、PHP 8で導入されたSTREAM_CRYPTO_PROTO_TLSv1_3定数とSTREAM_CRYPTO_METHOD_TLS_CLIENTを利用して、TLSv1.3プロトコルを用いた安全なクライアント接続を確立する方法を示しています。

connectTlsV1_3Client関数は、接続先のホスト名とポート番号を引数に取ります。まず、stream_context_create関数を使って、接続に関するオプション（特にmin_proto_versionとしてSTREAM_CRYPTO_PROTO_TLSv1_3を指定し、TLSv1.3以降のプロトコルを要求する設定）を持つストリームコンテキストを作成します。次に、stream_socket_client関数で指定されたホストとポートにTCPソケット接続を確立し、作成したコンテキストをこのソケットに紐付けます。その後、stream_socket_enable_crypto関数を用いて、このTCP接続上でTLS暗号化を有効にします。この際、STREAM_CRYPTO_METHOD_TLS_CLIENTを指定することで、クライアントとしてのTLS暗号化が実行され、先に設定したTLSv1.3の制約が適用されます。暗号化された接続が確立されると、HTTPリクエストの送信やサーバーからの応答の読み取りが可能になります。処理が成功した場合はサーバーからの応答文字列を返し、接続や暗号化の確立に失敗した場合はfalseを返します。