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

Copy
1<?php
2
3/**
4 * HTTPSリクエストを安全に実行するためのcURL関数。
5 * CURLOPT_SSL_VERIFYHOSTオプションを使用して、SSL証明書のホスト検証を行います。
6 *
7 * @param string $url リクエスト先のURL
8 * @return string|false リクエスト結果の文字列、または失敗した場合はfalse
9 */
10function makeSecureHttpsRequest(string $url): string|false
11{
12    // cURLセッションを初期化
13    $ch = curl_init();
14
15    // cURLオプションを設定
16    curl_setopt($ch, CURLOPT_URL, $url);
17    // 戻り値として転送結果を文字列で返すように設定
18    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
19
20    // ピア（接続先サーバー）のSSL証明書を検証するかどうかを設定
21    // trueに設定することで、サーバーが信頼できる認証局によって署名された証明書を使用しているかを確認します。
22    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
23
24    // ホスト名の検証レベルを設定
25    // 0: ホスト名を検証しない (非推奨、セキュリティリスクあり)
26    // 1: コモンネームのみを検証 (PHP 5.6.0以降では非推奨)
27    // 2: コモンネームとサブジェクト代替名を検証 (推奨)
28    // ここでは最も安全な「2」を設定しています。
29    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
30
31    // オプションで、証明書バンドルへのパスを設定することもできます。
32    // curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem');
33
34    // リクエストを実行し、結果を取得
35    $response = curl_exec($ch);
36
37    // エラーが発生した場合は、エラーメッセージを出力
38    if (curl_errno($ch)) {
39        echo 'cURL Error: ' . curl_error($ch) . PHP_EOL;
40        $response = false;
41    }
42
43    // cURLセッションを閉じる
44    curl_close($ch);
45
46    return $response;
47}
48
49// 使用例
50// 実際の安全なHTTPSエンドポイントに置き換えてください。
51// 例として、Googleのトップページを使用しています。
52$targetUrl = 'https://www.google.com/';
53
54echo "Attempting to fetch data from: " . $targetUrl . PHP_EOL;
55
56$data = makeSecureHttpsRequest($targetUrl);
57
58if ($data !== false) {
59    echo "Request successful. Received " . strlen($data) . " bytes." . PHP_EOL;
60    // 必要に応じて、データの最初の部分を表示
61    // echo "Data (first 500 chars): " . substr($data, 0, 500) . PHP_EOL;
62} else {
63    echo "Request failed." . PHP_EOL;
64}
65
66?>

このPHPサンプルコードは、cURLライブラリを使用して安全なHTTPSリクエストを実行する方法を示しています。makeSecureHttpsRequest関数は、指定されたURLにアクセスし、その結果を文字列として返すか、失敗した場合はfalseを返します。引数にはリクエスト先のURL（文字列）を受け取ります。

関数内部では、まずcurl_init()でcURLセッションを開始します。次にcurl_setopt()を使って様々なオプションを設定します。特に重要なのは、セキュリティに関わるCURLOPT_SSL_VERIFYPEERとCURLOPT_SSL_VERIFYHOSTです。CURLOPT_SSL_VERIFYPEERをtrueに設定することで、接続先のSSL証明書が信頼できる認証局によって署名されているかを検証します。これにより、偽装されたサーバーへの接続を防ぎます。

さらに、CURLOPT_SSL_VERIFYHOSTオプションは、SSL証明書に記載されているホスト名と実際に接続しているホスト名が一致するかを検証するために使用されます。サンプルコードでは最も安全なレベルである「2」を設定しており、これは証明書のコモンネームとサブジェクト代替名の両方を確認することを意味します。これにより、中間者攻撃（Man-in-the-Middle attack）のリスクを低減し、安全な通信を確保できます。これらの設定により、安全でない通信を防ぎ、データのやり取りの信頼性を高めることが可能です。

オプション設定後、curl_exec()でリクエストを実行し、curl_errno()でエラーがないかを確認します。最後にcurl_close()でセッションを閉じ、取得したレスポンスを返します。この一連の処理により、HTTPS通信における基本的なセキュリティ対策が施されたリクエストが実現されます。

Copy
1<?php
2
3/**
4 * cURLを使用して指定されたURLにHTTPリクエストを送信し、
5 * SSL/TLSプロトコルのバージョンを設定する関数です。
6 * システムエンジニアを目指す初心者向けに、`CURLOPT_SSLVERSION` オプションの
7 * 使用方法と基本的なcURLリクエストの流れを示します。
8 *
9 * @param string $url リクエストを送信するターゲットURL。
10 * @param int $sslVersion 使用するSSL/TLSプロトコルのバージョン定数。
11 *                        例: `CURL_SSLVERSION_TLSv1_2` (TLS 1.2)
12 *                        または `CURL_SSLVERSION_TLSv1_3` (TLS 1.3, PHP 7.4.0以降)
13 * @return string|false 成功した場合はサーバーからのレスポンス文字列、失敗した場合は `false`。
14 */
15function sendCurlRequestWithSslVersion(string $url, int $sslVersion = CURL_SSLVERSION_TLSv1_2): string|false
16{
17    // 1. cURLセッションを初期化します。
18    //    これにより、HTTPリクエストを送信するためのハンドルが作成されます。
19    $ch = curl_init();
20
21    // cURLの初期化に失敗した場合のエラーチェック
22    if ($ch === false) {
23        error_log('Error: Failed to initialize cURL session.');
24        return false;
25    }
26
27    // 2. cURLオプションを設定します。
28    //    `curl_setopt()` 関数を使って、様々なリクエスト設定を行います。
29
30    // リクエストを送信するターゲットURLを設定します。
31    curl_setopt($ch, CURLOPT_URL, $url);
32
33    // サーバーからの応答を直接出力せず、関数から文字列として返すように設定します。
34    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
35
36    // キーワードに関連するCURLOPT_SSLVERSIONオプションを設定します。
37    // このオプションは、クライアントがSSL/TLSハンドシェイク時に使用する
38    // プロトコルの最小バージョンを指定します。
39    // ここでは推奨される `CURL_SSLVERSION_TLSv1_2` (TLS 1.2) を例として設定しています。
40    curl_setopt($ch, CURLOPT_SSLVERSION, $sslVersion);
41
42    // 注意: SSL証明書の検証について
43    // 本番環境ではセキュリティを確保するため、`CURLOPT_SSL_VERIFYPEER` は `true` (デフォルト)
44    // `CURLOPT_SSL_VERIFYHOST` は `2` (デフォルト) に保ち、
45    // 適切なCA証明書バンドルを使用することが強く推奨されます。
46    // curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true); // ピアのSSL証明書を検証する
47    // curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);    // ホスト名の検証レベルを設定する
48
49    // 3. cURLリクエストを実行します。
50    //    設定されたオプションに基づいてHTTPリクエストが送信され、応答が返されます。
51    $response = curl_exec($ch);
52
53    // 4. エラーハンドリングを行います。
54    //    `curl_errno()` でエラーコードを取得し、`curl_error()` で詳細なエラーメッセージを取得します。
55    if (curl_errno($ch)) {
56        $errorMessage = curl_error($ch);
57        error_log('cURL Error (' . curl_errno($ch) . '): ' . $errorMessage);
58        // エラーが発生した場合、セッションを閉じ、falseを返します。
59        curl_close($ch);
60        return false;
61    }
62
63    // 5. cURLセッションを閉じます。
64    //    リソースを解放するために、セッションは必ず閉じます。
65    curl_close($ch);
66
67    // 成功した場合、取得したレスポンス文字列を返します。
68    return $response;
69}
70
71// === サンプルコードの実行例 ===
72// このセクションは、上記の関数がどのように使用されるかを示します。
73// 実際の利用時には、適切なHTTPS URLを指定してください。
74$targetUrl = 'https://example.com'; // アクセス可能なHTTPS Webサイトの例
75
76echo "CURL_SSLVERSION_TLSv1_2 を使用して '" . $targetUrl . "' にリクエストを送信します...\n";
77
78// 関数を呼び出し、`CURL_SSLVERSION_TLSv1_2` を指定してレスポンスを取得します。
79$responseData = sendCurlRequestWithSslVersion($targetUrl, CURL_SSLVERSION_TLSv1_2);
80
81if ($responseData !== false) {
82    echo "リクエスト成功！\n";
83    echo "取得したレスポンスの一部 (最初の500文字):\n";
84    // レスポンスが長い場合を考慮し、最初の500文字のみを表示します。
85    // コマンドラインでの表示を前提としているため、HTMLエスケープは行いません。
86    echo substr($responseData, 0, 500) . "...\n";
87} else {
88    echo "リクエスト失敗。詳細については上記のエラーログを確認してください。\n";
89}
90
91// 必要に応じて、TLSv1.3などの異なるSSLバージョンを試すこともできます。
92// (PHP 7.4.0 以降で `CURL_SSLVERSION_TLSv1_3` が利用可能です。)
93/*
94if (defined('CURL_SSLVERSION_TLSv1_3')) {
95    echo "\nCURL_SSLVERSION_TLSv1_3 を使用して '" . $targetUrl . "' にリクエストを送信します...\n";
96    $responseDataTls13 = sendCurlRequestWithSslVersion($targetUrl, CURL_SSLVERSION_TLSv1_3);
97
98    if ($responseDataTls13 !== false) {
99        echo "リクエスト成功 (TLSv1.3)！\n";
100        echo "取得したレスポンスの一部 (最初の500文字):\n";
101        echo substr($responseDataTls13, 0, 500) . "...\n";
102    } else {
103        echo "リクエスト失敗 (TLSv1.3)。詳細についてはエラーログを確認してください。\n";
104    }
105}
106*/
107
108?>

このPHPサンプルコードは、cURLライブラリを用いてHTTPリクエストを送信する基本的な方法と、特にSSL/TLSプロトコルのバージョンを制御する方法を、システムエンジニアを目指す初心者向けに解説しています。sendCurlRequestWithSslVersion 関数は、アクセスしたいURLを $url 引数で受け取り、通信に使用するSSL/TLSプロトコルバージョンを $sslVersion 引数で設定します。例えば、CURL_SSLVERSION_TLSv1_2 を指定することで、TLS 1.2以上のプロトコルバージョンで通信を試みます。

処理の基本的な流れとして、まず curl_init() でcURLセッションを初期化し、HTTPリクエストを送信するための準備を整えます。次に curl_setopt() 関数を使い、様々なリクエストオプションを設定します。具体的には、CURLOPT_URL でリクエスト先のURLを指定し、CURLOPT_RETURNTRANSFER を true に設定することで、サーバーからの応答内容を関数の戻り値として文字列で取得できるようにします。そして、このコードの重要なポイントである CURLOPT_SSLVERSION オプションで、通信に使うSSL/TLSプロトコルのバージョンを指定します。

オプション設定が完了したら、curl_exec() で実際にHTTPリクエストを実行し、サーバーからの応答を受け取ります。もしリクエスト中に何らかのエラーが発生した場合は、curl_errno() や curl_error() を使ってエラー情報を取得し、ログに記録するなどの適切なエラー処理を行います。最後に、curl_close() を呼び出してcURLセッションを閉じ、使用したリソースを解放することが重要です。この関数の戻り値は、リクエストが成功した場合はサーバーからのレスポンス文字列、失敗した場合は false となります。これにより、ウェブ通信の安全性を確保しながら、プロトコルバージョンを制御する基礎を学ぶことができます。