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

Copy
1<?php
2
3/**
4 * 指定されたHTTPS URLへプロキシ経由でリクエストを送信します。
5 *
6 * CURLPROTO_HTTPS 定数は、cURLがHTTPSプロトコルを処理することを許可するビットフィールドです。
7 * CURLOPT_PROTOCOLS オプションと組み合わせることで、
8 * プロキシ経由であっても、最終的な通信先がHTTPSである場合に、
9 * そのプロトコルが許可されていることを明示的に指定できます。
10 *
11 * @param string $url リクエストを送信するHTTPS URL
12 * @param string $proxyHost プロキシサーバーのホスト名またはIPアドレス
13 * @param int $proxyPort プロキシサーバーのポート番号
14 * @return string|false リクエストのレスポンスボディ、または失敗した場合はfalse
15 */
16function makeHttpsRequestViaProxy(string $url, string $proxyHost, int $proxyPort)
17{
18    // cURLセッションを初期化
19    $ch = curl_init();
20
21    if (false === $ch) {
22        echo "エラー: cURLセッションの初期化に失敗しました。\n";
23        return false;
24    }
25
26    // リクエスト先のURLを設定
27    curl_setopt($ch, CURLOPT_URL, $url);
28
29    // プロキシサーバーのホスト名とポート番号を設定
30    curl_setopt($ch, CURLOPT_PROXY, $proxyHost);
31    curl_setopt($ch, CURLOPT_PROXYPORT, $proxyPort);
32
33    // プロキシ経由で認証が必要な場合は以下の行をコメント解除し、適切な値に置き換えてください。
34    // curl_setopt($ch, CURLOPT_PROXYUSERPWD, 'your_proxy_user:your_proxy_password');
35    // プロキシのタイプを設定（一般的なHTTPプロキシの場合）
36    // curl_setopt($ch, CURLOPT_PROXYTYPE, CURLPROXY_HTTP);
37
38    // レスポンスを文字列として取得し、直接出力しないように設定
39    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
40
41    // 許可するプロトコルにHTTPSとHTTPを含めます。
42    // これにより、cURLがプロキシ経由でHTTPSサイトにアクセスする際に、
43    // HTTPSプロトコルが許可されていることを明確にします。
44    curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTPS | CURLPROTO_HTTP);
45
46    // SSL証明書の検証を無効にする（開発・テスト環境用、本番環境では非推奨）。
47    // 本番環境では、信頼できるCA証明書バンドルを使用して検証を有効にすることを強く推奨します。
48    // curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
49    // curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); // PHP 5.6以降は推奨されません。代わりにVERIFYPEERを使用します。
50
51    // cURLリクエストを実行
52    $response = curl_exec($ch);
53
54    // エラーが発生した場合は、エラー情報を表示
55    if (false === $response) {
56        $error = curl_error($ch);
57        echo "cURLエラー: " . $error . "\n";
58    }
59
60    // cURLセッションを閉じる
61    curl_close($ch);
62
63    return $response;
64}
65
66// --- サンプル使用例 ---
67// 実際に動作させるには、有効なプロキシサーバーとインターネット上のHTTPSサイトが必要です。
68// 以下のプレースホルダーを実際の情報に置き換えてください。
69$targetUrl = 'https://www.example.com'; // 例: ターゲットのHTTPS URL
70$proxyHost = 'your_proxy_host.com';     // 例: プロキシサーバーのホスト名またはIPアドレス
71$proxyPort = 8080;                      // 例: プロキシサーバーのポート番号
72
73echo "プロキシ経由で {$targetUrl} にアクセスを試みています...\n";
74
75$data = makeHttpsRequestViaProxy($targetUrl, $proxyHost, $proxyPort);
76
77if ($data !== false) {
78    echo "データ取得に成功しました (一部表示):\n";
79    // 取得したデータの一部を表示（長すぎる場合に備えて最初の500文字に切り詰める）
80    echo mb_substr($data, 0, 500) . "...\n";
81} else {
82    echo "データ取得に失敗しました。\n";
83}
84

このPHPのサンプルコードは、makeHttpsRequestViaProxy関数を通じて、プロキシサーバーを経由して指定されたHTTPS URLにリクエストを送信する方法を示しています。関数は、ターゲットとなるHTTPSのURLを$url、プロキシサーバーのホスト名またはIPアドレスを$proxyHost、ポート番号を$proxyPortとして受け取ります。処理が成功した場合はターゲットサーバーからのレスポンスボディを文字列として返し、失敗した場合はfalseを返します。

ここで使用されているCURLPROTO_HTTPS定数は、cURLがHTTPSプロトコルを処理することを許可するビットフィールドを表す整数値です。curl_setopt関数でCURLOPT_PROTOCOLSオプションにCURLPROTO_HTTPSとCURLPROTO_HTTPを組み合わせて設定することで、cURLがプロキシを介してHTTPSサイトにアクセスする際に、最終的な通信がHTTPSプロトコルであることを明示的に許可します。これにより、セキュリティを確保しつつ、プロキシ経由でのHTTPS通信が可能になります。その他にも、CURLOPT_URLでリクエスト先URLを、CURLOPT_PROXYとCURLOPT_PROXYPORTでプロキシ設定を行い、CURLOPT_RETURNTRANSFERでレスポンスを文字列として取得するよう設定しています。この機能は、ネットワーク環境の制約がある場合や、特定のプロキシ経由で外部サービスと連携するシステム構築に役立ちます。

Copy
1<?php
2
3/**
4 * cURLを使用して指定されたURLからコンテンツを取得します。
5 * この関数は、許可されるプロトコルをHTTPSのみに制限します。
6 *
7 * @param string $url リクエストを送信するURL。
8 * @return string|false レスポンス本文、またはエラー時にfalse。
9 */
10function fetchHttpsOnlyContent(string $url): string|false
11{
12    // cURLセッションを初期化します。
13    $ch = curl_init();
14
15    if ($ch === false) {
16        error_log("cURLセッションの初期化に失敗しました。");
17        return false;
18    }
19
20    // リクエスト先のURLを設定します。
21    curl_setopt($ch, CURLOPT_URL, $url);
22
23    // レスポンスを文字列として取得し、直接出力しないようにします。
24    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
25
26    // 許可するプロトコルをHTTPSのみに制限します。
27    // CURLPROTO_HTTPSは、HTTPSプロトコルのみを許可する定数です。
28    // これにより、例えばHTTPへの意図しないリダイレクトを防ぎ、セキュリティを向上させることができます。
29    curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTPS);
30
31    // SSL証明書の検証を有効にします（本番環境では強く推奨されます）。
32    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
33    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
34
35    // cURLリクエストを実行します。
36    $response = curl_exec($ch);
37
38    // エラーチェック
39    if (curl_errno($ch)) {
40        error_log("cURLエラーが発生しました: " . curl_error($ch));
41        $response = false; // エラーが発生したためfalseを返します。
42    }
43
44    // cURLセッションを閉じ、リソースを解放します。
45    curl_close($ch);
46
47    return $response;
48}
49
50// --- 以下は上記関数を動作させるための実行例です ---
51
52// 動作確認用のHTTPS URLを指定してください。
53$targetUrl = 'https://www.example.com'; 
54
55echo "指定されたURLからコンテンツを取得中: " . $targetUrl . PHP_EOL;
56
57// 関数を呼び出し、結果を取得します。
58$content = fetchHttpsOnlyContent($targetUrl);
59
60if ($content !== false) {
61    echo "コンテンツの取得に成功しました。先頭200文字を表示します。\n";
62    echo substr($content, 0, 200) . "..." . PHP_EOL;
63} else {
64    echo "コンテンツの取得に失敗しました。\n";
65    echo "エラーログまたは上記のエラーメッセージを確認してください。\n";
66}
67
68?>

このサンプルコードは、PHPのcURLライブラリを用いて指定されたURLからコンテンツを安全に取得するfetchHttpsOnlyContent関数を定義しています。

この関数は、引数としてコンテンツを取得したいURL（文字列型）を受け取り、処理に成功した場合はそのコンテンツの本文を文字列型で返します。万が一、通信エラーなどにより取得に失敗した場合はfalseを戻り値として返します。

関数内では、まずcurl_init()でcURLセッションを開始し、その後のcurl_setopt()関数で様々な通信オプションを設定します。特に重要なのは、CURLOPT_PROTOCOLSオプションに**CURLPROTO_HTTPS**定数を指定している点です。この定数は、許可する通信プロトコルをHTTPSのみに限定する役割を持っています。これにより、HTTPのようなセキュアでないプロトコルでの接続や、HTTPSからHTTPへの意図しないリダイレクトを強力に防ぎ、通信の安全性を大幅に向上させています。

さらに、SSL証明書の検証を有効にする設定も行い、通信相手の信頼性も確認しています。すべての設定が完了した後、curl_exec()で実際のリクエストを実行し、エラーが発生した場合はエラーログに記録してfalseを返します。最終的に、curl_close()でcURLセッションを閉じ、使用したリソースを解放します。このようにCURLPROTO_HTTPSを活用することで、外部コンテンツを安全かつ信頼性の高い方法で取得することが可能になります。