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

Copy
1<?php
2
3/**
4 * 指定されたURLに対し、プロキシ経由でcURLリクエストを実行します。
5 *
6 * システムエンジニアを目指す初心者の方へ:
7 * この関数は、ウェブサイトからデータを取得するためのcURLライブラリを使用し、
8 * プロキシサーバー経由でリクエストを送信する方法を示します。
9 * プロキシは、あなたのコンピュータとインターネットの間でリクエストを中継するサーバーです。
10 * これにより、セキュリティ強化や特定のネットワーク要件への対応が可能になります。
11 *
12 * @param string $url リクエストを送信するターゲットURL。
13 * @param string $proxyHost プロキシサーバーのホスト名またはIPアドレス (例: '192.168.1.1' や 'proxy.example.com')。
14 * @param int $proxyPort プロキシサーバーのポート番号 (例: 8080, 3128)。
15 * @return string|false リクエストが成功した場合はレスポンスの文字列、失敗した場合はfalse。
16 */
17function makeCurlRequestWithProxy(string $url, string $proxyHost, int $proxyPort)
18{
19    // cURLセッションを初期化します。
20    // curl_init() は、新しいcURLセッションを作成し、それを識別するためのハンドルを返します。
21    $ch = curl_init();
22
23    // cURLセッションの初期化に失敗した場合のチェック。
24    if ($ch === false) {
25        echo "エラー: cURLセッションの初期化に失敗しました。\n";
26        return false;
27    }
28
29    // cURLオプションを設定します。
30    // curl_setopt() は、特定のcURLセッションのオプションを設定するために使用されます。
31
32    // リクエストを送信するURLを設定します。
33    curl_setopt($ch, CURLOPT_URL, $url);
34
35    // リクエストの結果を直接出力せず、関数の戻り値として文字列で取得する設定です。
36    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
37
38    // HTTPリダイレクト（例: 301 Moved Permanently）があった場合に、自動的に新しい場所へ追跡する設定です。
39    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
40
41    // リクエストのタイムアウトを秒単位で設定します。ここでは10秒です。
42    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
43
44    // プロキシサーバーのホスト名またはIPアドレスを設定します。(キーワードに関連)
45    curl_setopt($ch, CURLOPT_PROXY, $proxyHost);
46
47    // プロキシサーバーのポート番号を設定します。(キーワードに関連)
48    curl_setopt($ch, CURLOPT_PROXYPORT, $proxyPort);
49
50    // プロキシサーバーのタイプを設定します。ここではHTTPプロキシを使用します。
51    curl_setopt($ch, CURLOPT_PROXYTYPE, CURLPROXY_HTTP);
52
53    // 許可するプロトコルを設定します。(リファレンス情報: CURLOPT_PROTOCOLS)
54    // ここではHTTPとHTTPSのみを許可しています。これにより、意図しないプロトコルへの接続を防ぎ、セキュリティを向上させます。
55    curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS);
56
57    // HTTPSリクエストの場合、SSL証明書の検証を行うかどうかを設定します。
58    // 本番環境ではセキュリティのため `true` に設定し、信頼できない証明書を拒否することが強く推奨されます。
59    // 例のために `false` に設定していますが、これはセキュリティ上のリスクを伴うことを理解してください。
60    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // ピア（接続先サーバー）のSSL証明書を検証しない
61    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); // ホスト名が証明書と一致するかを検証しない (非推奨)
62
63    // cURLリクエストを実行し、結果を取得します。
64    $response = curl_exec($ch);
65
66    // cURLリクエストの実行中にエラーが発生したかどうかをチェックします。
67    if (curl_errno($ch)) {
68        // エラーがあった場合、エラー番号とエラーメッセージを出力します。
69        echo 'cURLエラー (' . curl_errno($ch) . '): ' . curl_error($ch) . "\n";
70        $response = false; // エラー時はfalseを返します。
71    }
72
73    // cURLセッションを閉じ、関連するリソースを解放します。
74    curl_close($ch);
75
76    return $response;
77}
78
79// --- サンプル実行 ---
80// このコードを実際に実行するには、有効なプロキシサーバーとインターネット接続が必要です。
81// 以下のプロキシ設定はダミーです。ご自身の環境に合わせて正しい情報に変更してください。
82
83$targetUrl = 'http://example.com'; // アクセスしたいウェブサイトのURL
84$proxyHost = 'your.proxy.server';  // 例: '192.168.1.1' や 'proxy.company.com'
85$proxyPort = 8080;                 // 例: 8080, 3128, 8888 など
86
87echo "--- プロキシ経由で '" . $targetUrl . "' にリクエストを送信します ---\n";
88echo "使用プロキシ: " . $proxyHost . ":" . $proxyPort . "\n";
89echo "注意: 上記プロキシ設定はダミーです。実際に動作するプロキシ情報に置き換えてください。\n\n";
90
91$result = makeCurlRequestWithProxy($targetUrl, $proxyHost, $proxyPort);
92
93if ($result !== false) {
94    echo "--- レスポンスの最初の500文字を表示 ---\n";
95    echo substr($result, 0, 500) . "...\n";
96    // 取得したHTMLコンテンツを全て表示したい場合は以下のコメントを解除してください。
97    // echo $result;
98} else {
99    echo "リクエストが失敗しました。プロキシ設定、ネットワーク接続、またはターゲットURLを確認してください。\n";
100}

このコードは、makeCurlRequestWithProxyという関数を通じて、プロキシサーバーを経由して指定されたURLへHTTPリクエストを送信する方法を示しています。プロキシは、あなたのコンピューターとインターネットの間の通信を中継するサーバーで、セキュリティ強化や特定のネットワーク制限下でのアクセスを可能にします。

関数はまずcurl_init()でcURLセッションを初期化し、curl_setopt()を用いて様々なオプションを設定します。CURLOPT_URLでアクセスしたいウェブサイトのURLを、CURLOPT_PROXYとCURLOPT_PROXYPORTでプロキシサーバーのホスト名とポート番号を指定します。特にCURLOPT_PROTOCOLSオプションは、許可するプロトコルをHTTPとHTTPSに限定することで、意図しないプロトコルへの接続を防ぎ、セキュリティを向上させる役割があります。

CURLOPT_RETURNTRANSFERをtrueに設定すると、リクエスト結果を関数の戻り値として文字列で取得でき、CURLOPT_FOLLOWLOCATIONをtrueにすると、ウェブサイトのリダイレクトに自動的に追従します。また、SSL証明書の検証に関するCURLOPT_SSL_VERIFYPEERやCURLOPT_SSL_VERIFYHOSTも設定されますが、本番環境ではセキュリティ強化のためtrueに設定することが推奨されます。

すべてのオプション設定後、curl_exec()で実際のリクエストを実行し、結果を取得します。エラーが発生した場合はcurl_errno()で確認し、最後にcurl_close()でセッションを適切に閉じます。引数として $url (ターゲットURL)、$proxyHost (プロキシのホスト名)、$proxyPort (プロキシのポート番号) を受け取り、成功した場合はレスポンス文字列、失敗した場合はfalseを返します。

Copy
1<?php
2
3/**
4 * 指定されたURLに対してcURLでHTTPSリクエストを実行し、
5 * SSL/TLSバージョンを明示的に設定するサンプルコードです。
6 *
7 * システムエンジニアを目指す初心者の方へ：
8 * HTTPS通信は、インターネット上でデータを安全に送受信するための重要なプロトコルです。
9 * このコードでは、cURLライブラリを使用してHTTPSリクエストを行い、特に
10 * 通信で使用するSSL/TLS (Secure Sockets Layer/Transport Layer Security) のバージョンを
11 * `CURLOPT_SSLVERSION` オプションで明示的に指定する方法を示しています。
12 *
13 * 古いSSL/TLSバージョン（例: SSLv3, TLSv1.0, TLSv1.1）にはセキュリティ上の脆弱性が
14 * 見つかっているため、安全な通信を確立するためには、最新かつ推奨されるバージョン
15 * （例: TLSv1.2, TLSv1.3）を使用することが非常に重要です。
16 *
17 * @param string $url リクエストを送信するHTTPSのURL
18 * @return string|false リクエストが成功した場合はレスポンス本文、失敗した場合はfalse
19 */
20function fetchSecureContent(string $url)
21{
22    // cURLセッションを初期化します。
23    $ch = curl_init();
24
25    // cURLオプションを設定します。
26
27    // 1. リクエストを送信するURLを設定します。
28    curl_setopt($ch, CURLOPT_URL, $url);
29
30    // 2. サーバーからのレスポンスを文字列として取得するように設定します。
31    //    これをtrueにしない場合、レスポンスは直接出力されます。
32    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
33
34    // 3. SSL/TLSのピア（接続先サーバー）の証明書を検証するかどうかを設定します。
35    //    本番環境では必ずtrue（検証を有効）にしてください。falseにするとセキュリティリスクが高まります。
36    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
37
38    // 4. SSL/TLSのホスト名（サーバー名）が証明書と一致するかを検証するかどうかを設定します。
39    //    2は、共通名 (CN) またはサブジェクト代替名 (SAN) がホスト名と一致することを要求します。
40    //    本番環境では必ず2に設定してください。
41    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
42
43    // 5. 使用するSSL/TLSのバージョンを明示的に指定します。
44    //    このオプションは、どのSSL/TLSプロトコルバージョンでハンドシェイクを行うかをcURLに指示します。
45    //    CURLOPT_PROTOCOLS は cURL が使用できる "上位レベルの" プロトコル (HTTP, HTTPS, FTPなど) を
46    //    制限するのに対し、CURLOPT_SSLVERSION は "HTTPSプロトコル内部" で使用するSSL/TLSのバージョンを制御します。
47    //
48    //    ここでは TLSv1.2 を指定しています。
49    //    PHP 8 環境では通常、デフォルトで安全なバージョンが選択されますが、
50    //    特定の要件や古いサーバーとの互換性が必要な場合に明示的に指定することがあります。
51    //    より新しい CURL_SSLVERSION_TLSv1_3 も利用可能であり、推奨されます。
52    //    古いバージョン (SSLv2, SSLv3, TLSv1.0, TLSv1.1) の使用は避けるべきです。
53    curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_2);
54
55    // cURLセッションを実行し、レスポンスを取得します。
56    $response = curl_exec($ch);
57
58    // cURLの実行中にエラーが発生したかを確認します。
59    if (curl_errno($ch)) {
60        // エラーメッセージを出力し、falseを返します。
61        error_log('cURL Error (' . curl_errno($ch) . '): ' . curl_error($ch));
62        $response = false;
63    }
64
65    // cURLセッションを閉じ、リソースを解放します。
66    curl_close($ch);
67
68    return $response;
69}
70
71// サンプルコードの実行例：
72// 以下のURLはテスト用です。実際に動作確認する際は、アクセス可能なHTTPSサイトを指定してください。
73// 例: 'https://api.github.com/zen' (GitHubのシンプルなAPIエンドポイント)
74$targetUrl = 'https://www.google.com';
75
76echo "指定されたURLから安全にコンテンツを取得を試みます: " . $targetUrl . PHP_EOL;
77
78$content = fetchSecureContent($targetUrl);
79
80if ($content !== false) {
81    echo "コンテンツの取得に成功しました。先頭200文字を表示します:" . PHP_EOL;
82    echo substr($content, 0, 200) . "..." . PHP_EOL;
83} else {
84    echo "コンテンツの取得に失敗しました。上記のエラーログを確認してください。" . PHP_EOL;
85}

このPHPサンプルコードは、cURLライブラリを使用して指定されたHTTPSのURLに対して安全なリクエストを実行し、特にSSL/TLS通信で使用するバージョンを明示的に制御する方法を示しています。関数fetchSecureContentは、引数としてリクエストを送信する$url（文字列型）を受け取ります。成功時にはウェブサイトのコンテンツを文字列として返し、失敗した場合はfalseを返します。

コードの中心となるのはCURLOPT_SSLVERSIONオプションです。これは、HTTPS通信において、どのSSL/TLSプロトコルバージョン（例: TLSv1.2, TLSv1.3）を使用するかをcURLに指示するもので、古いバージョンに存在するセキュリティ脆弱性を避けるために重要です。推奨される最新のバージョンを選択することで、通信の安全性を高めることができます。一方、CURLOPT_PROTOCOLSはcURLが利用できる上位レベルのプロトコル（HTTP, HTTPS, FTPなど）を制限するオプションであり、CURLOPT_SSLVERSIONがHTTPS内部のSSL/TLSバージョンを制御するのとは目的が異なります。

さらに、CURLOPT_SSL_VERIFYPEERとCURLOPT_SSL_VERIFYHOSTオプションを設定することで、接続先のサーバーが正規のサーバーであることを証明書で検証し、中間者攻撃などのリスクを軽減しています。これらは本番環境でのHTTPS通信において必須のセキュリティ設定です。