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

Copy
1<?php
2
3/**
4 * 指定されたURLにプロキシ経由でHTTP GETリクエストを送信します。
5 * cURLセッションで許可されるプロトコルをHTTPのみに制限します。
6 *
7 * @param string $url リクエスト先のURL。例: 'http://example.com'
8 * @param string $proxyHost プロキシサーバーのホスト名またはIPアドレス。例: '127.0.0.1'
9 * @param int $proxyPort プロキシサーバーのポート番号。例: 8888
10 * @return string|false リクエストが成功した場合はレスポンスボディ、失敗した場合はfalse。
11 */
12function fetchUrlWithHttpProxy(string $url, string $proxyHost, int $proxyPort): string|false
13{
14    // cURLセッションを初期化
15    $ch = curl_init();
16
17    if ($ch === false) {
18        // cURLセッションの初期化に失敗した場合
19        error_log("cURLセッションの初期化に失敗しました。");
20        return false;
21    }
22
23    // cURLオプションを設定
24    curl_setopt($ch, CURLOPT_URL, $url);                // リクエスト先のURLを設定
25    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);     // レスポンスを文字列として取得する
26    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);     // リダイレクトを自動的に追跡する
27    curl_setopt($ch, CURLOPT_TIMEOUT, 10);              // タイムアウトを10秒に設定
28
29    // プロキシサーバーの設定
30    curl_setopt($ch, CURLOPT_PROXY, $proxyHost);       // プロキシサーバーのホスト名またはIPアドレス
31    curl_setopt($ch, CURLOPT_PROXYPORT, $proxyPort);   // プロキシサーバーのポート番号
32
33    // 許可するプロトコルをHTTPのみに制限
34    // CURLPROTO_HTTP は、cURLが使用できるプロトコルとしてHTTPのみを許可する定数です。
35    // これにより、意図せず他のプロトコル（HTTPSなど）でリクエストが送信されることを防ぎます。
36    curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTP);
37
38    // リクエストを実行し、レスポンスを取得
39    $response = curl_exec($ch);
40
41    // cURL実行中のエラーをチェック
42    if (curl_errno($ch)) {
43        $errorMessage = curl_error($ch);
44        error_log("cURLエラーが発生しました: " . $errorMessage);
45        curl_close($ch);
46        return false;
47    }
48
49    // HTTPステータスコードをチェックし、400番台以上のエラーを検出
50    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
51    if ($httpCode >= 400) {
52        error_log("HTTPエラーが発生しました: ステータスコード " . $httpCode . " for URL " . $url);
53        curl_close($ch);
54        return false;
55    }
56
57    // cURLセッションを閉じる
58    curl_close($ch);
59
60    return $response;
61}
62
63// --- 使用例 ---
64// 注意: 以下のプロキシ設定はダミーです。
65// このコードを実際に動作させるには、有効なプロキシサーバー（例: Squid, Fiddler, Charlesなど）が必要です。
66// ローカルでプロキシを立てるか、信頼できる公開プロキシを使用してください。
67
68$targetUrl = 'http://example.com'; // プロキシ経由で取得したいウェブサイトのURL
69$proxyHost = '127.0.0.1';          // プロキシサーバーのIPアドレス (例: ローカルホスト)
70$proxyPort = 8888;                 // プロキシサーバーのポート番号 (一般的なプロキシのデフォルトポート)
71
72echo "URL: '{$targetUrl}' をプロキシ '{$proxyHost}:{$proxyPort}' 経由で取得します...\n";
73
74// 関数を呼び出してプロキシ経由でURLにアクセス
75$result = fetchUrlWithHttpProxy($targetUrl, $proxyHost, $proxyPort);
76
77if ($result !== false) {
78    echo "成功! レスポンスの長さ: " . strlen($result) . " バイト。\n";
79    // 取得したレスポンスの最初の200バイトを表示
80    echo "レスポンスの一部:\n" . substr($result, 0, 200) . "...\n";
81} else {
82    echo "失敗しました。プロキシ経由でのURL取得に失敗しました。\n";
83    echo "エラーログを確認してください。\n";
84}

このPHPサンプルコードは、PHP 8のcURL拡張機能を利用してプロキシサーバー経由でHTTP GETリクエストを送信する方法を、システムエンジニアの初心者の方にも分かりやすく説明しています。fetchUrlWithHttpProxy関数は、アクセスしたいURL、プロキシサーバーのホスト名、ポート番号を引数として受け取り、成功した場合はウェブサイトのコンテンツ（レスポンスボディ）を文字列で、失敗した場合はfalseを返します。

関数内では、まずcurl_init()でcURLセッションを開始し、curl_setopt()で様々な設定を行います。リクエスト先のURLやレスポンスを文字列で取得する設定、リダイレクトの追跡、タイムアウト時間を設定しています。プロキシサーバーの情報はCURLOPT_PROXYとCURLOPT_PROXYPORTオプションで指定します。

特に重要なのは、CURLOPT_PROTOCOLSオプションに定数CURLPROTO_HTTPを設定している点です。このCURLPROTO_HTTPは、cURL拡張機能が提供する定数（int型の値）であり、cURLセッションで使用できるプロトコルをHTTPに限定します。これにより、意図せずHTTPSなどの他のプロトコルで通信が試みられることを防ぎ、通信の安全性や意図したプロトコルでの動作を保証します。リクエストの実行後には、エラーハンドリングを行い、エラー発生時には適切なログ出力とともにfalseを返して処理を終了します。

Copy
1<?php
2
3/**
4 * 指定されたURLにプロキシ経由でHTTPリクエストを送信し、その結果を返します。
5 *
6 * @param string $url アクセス対象のURL。
7 * @param string $proxyHost プロキシサーバーのホスト名またはIPアドレス。
8 * @param int $proxyPort プロキシサーバーのポート番号。
9 * @param string|null $proxyUser プロキシ認証のユーザー名 (オプション)。
10 * @param string|null $proxyPass プロキシ認証のパスワード (オプション)。
11 * @return string|null 成功した場合は取得したコンテンツ、失敗した場合はnull。
12 */
13function fetchUrlThroughProxy(string $url, string $proxyHost, int $proxyPort, ?string $proxyUser = null, ?string $proxyPass = null): ?string
14{
15    // cURL セッションを初期化します。
16    // cURL は様々なプロトコルを使ってデータ転送を行うためのライブラリです。
17    $ch = curl_init();
18
19    // cURL の初期化に失敗した場合の処理
20    if ($ch === false) {
21        // エラーログに出力し、null を返します。
22        error_log("cURL の初期化に失敗しました。");
23        return null;
24    }
25
26    // ----------------------------------------------------
27    // cURL オプションの設定
28    // ----------------------------------------------------
29
30    // 1. アクセス対象のURLを設定
31    curl_setopt($ch, CURLOPT_URL, $url);
32
33    // 2. プロキシサーバーの情報を設定
34    // CURLOPT_PROXY: プロキシサーバーのホスト名またはIPアドレスを指定します。
35    curl_setopt($ch, CURLOPT_PROXY, $proxyHost);
36    // CURLOPT_PROXYPORT: プロキシサーバーのポート番号を指定します。
37    curl_setopt($ch, CURLOPT_PROXYPORT, $proxyPort);
38
39    // 3. プロキシ認証が必要な場合の設定
40    // CURLOPT_PROXYUSERPWD: "ユーザー名:パスワード" の形式で認証情報を指定します。
41    if ($proxyUser !== null && $proxyPass !== null) {
42        curl_setopt($ch, CURLOPT_PROXYUSERPWD, "{$proxyUser}:{$proxyPass}");
43    }
44
45    // 4. CURLPROTO_HTTP を使用して、許可するプロトコルをHTTPに制限
46    // CURLOPT_PROTOCOLS: cURL が処理を許可するプロトコルを指定します。
47    // ここでは CURLPROTO_HTTP を指定し、HTTPプロトコルのみを許可しています。
48    // これはセキュリティ hardening の一環として、意図しないプロトコルへの接続を防ぐのに役立ちます。
49    curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTP);
50    // CURLOPT_REDIR_PROTOCOLS: リダイレクト時に許可するプロトコルを指定します。
51    // 同様に CURLPROTO_HTTP を指定し、リダイレクト先もHTTPプロトコルに制限します。
52    curl_setopt($ch, CURLOPT_REDIR_PROTOCOLS, CURLPROTO_HTTP);
53
54
55    // 5. 転送結果を文字列として受け取るように設定
56    // CURLOPT_RETURNTRANSFER: true に設定すると、curl_exec() の戻り値が取得したコンテンツの文字列になります。
57    // false の場合、結果は直接出力されます。
58    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
59
60    // 6. エラーが発生した場合に、curl_exec() が FALSE を返すように設定
61    // CURLOPT_FAILONERROR: HTTPステータスコードが400以上の場合に FALSE を返します。
62    curl_setopt($ch, CURLOPT_FAILONERROR, true);
63
64    // ----------------------------------------------------
65    // cURL リクエストの実行と結果の処理
66    // ----------------------------------------------------
67
68    // cURL リクエストを実行します。
69    $response = curl_exec($ch);
70
71    // cURL の実行中にエラーが発生したかチェック
72    if (curl_errno($ch)) {
73        // エラーメッセージを取得
74        $errorMsg = curl_error($ch);
75        // エラーログに出力
76        error_log("cURL エラー発生: " . $errorMsg);
77        // エラー時は null を返します
78        $response = null;
79    }
80
81    // cURL セッションを終了し、リソースを解放します。
82    curl_close($ch);
83
84    return $response;
85}
86
87// --- サンプルコードの利用例 ---
88
89// ここでアクセスしたいURLとプロキシ情報を設定します。
90// 実際に動作させるには、有効なプロキシサーバーとアクセス可能なURLに置き換えてください。
91$targetUrl = 'http://httpbin.org/get'; // プロキシ経由でアクセスする検証用URL
92$proxyHost = 'your_proxy_host';       // あなたのプロキシサーバーのホスト名またはIPアドレス
93$proxyPort = 8080;                    // あなたのプロキシサーバーのポート番号 (例: 8080, 3128)
94
95// プロキシ認証が必要な場合は、以下のコメントを解除し、ユーザー名とパスワードを設定してください。
96// $proxyUser = 'your_proxy_username';
97// $proxyPass = 'your_proxy_password';
98$proxyUser = null;
99$proxyPass = null;
100
101echo "--- プロキシ経由でのHTTPリクエストテスト ---\n";
102echo "ターゲットURL: " . $targetUrl . "\n";
103echo "プロキシサーバー: " . $proxyHost . ":" . $proxyPort . "\n";
104if ($proxyUser) {
105    echo "プロキシ認証: 必要 (ユーザー名: " . $proxyUser . ")\n";
106} else {
107    echo "プロキシ認証: 不要\n";
108}
109echo "-----------------------------------------\n\n";
110
111// プロキシ経由でURLにアクセスを試みます。
112$content = fetchUrlThroughProxy($targetUrl, $proxyHost, $proxyPort, $proxyUser, $proxyPass);
113
114if ($content !== null) {
115    echo "HTTPリクエスト成功！\n";
116    echo "取得したコンテンツの最初の500文字:\n";
117    echo substr($content, 0, 500) . "...\n";
118} else {
119    echo "HTTPリクエスト失敗。上記のエラーログを確認してください。\n";
120    echo "プロキシ設定、ネットワーク接続、またはターゲットURLが正しいか確認してください。\n";
121}
122
123?>

このPHPコードは、cURLライブラリを利用して、プロキシサーバーを経由して指定されたURLへHTTPリクエストを送信し、その結果を取得する方法を示しています。

fetchUrlThroughProxy関数は、アクセスしたいURL、プロキシサーバーのホスト名とポート番号、さらに必要であればプロキシ認証のためのユーザー名とパスワードを引数に取ります。この関数は、リクエストが成功した場合には取得したコンテンツを文字列として返し、失敗した場合はnullを返します。

関数内部では、まずcurl_init()でcURLセッションを初期化し、様々なオプションを設定します。プロキシサーバーのアドレスとポートはCURLOPT_PROXYとCURLOPT_PROXYPORTで設定され、プロキシ認証が必要な場合はCURLOPT_PROXYUSERPWDで認証情報を指定します。

特に注目すべきは、CURLOPT_PROTOCOLSとCURLOPT_REDIR_PROTOCOLSオプションでCURLPROTO_HTTP定数を使用している点です。CURLPROTO_HTTPは、cURLが接続やリダイレクトを許可するプロトコルをHTTPに限定するための定数です。これにより、意図しないプロトコルへの接続を防ぎ、セキュリティの強化に役立ちます。

また、CURLOPT_RETURNTRANSFERをtrueに設定することで、curl_exec()関数の実行結果として取得したコンテンツが文字列で返されるようになります。CURLOPT_FAILONERRORは、HTTPステータスコードがエラー（400番台以上）の場合にcurl_exec()がfalseを返すように設定するオプションです。

最終的にcurl_exec()でリクエストが実行され、エラーがなければコンテンツが取得されます。処理が終わるとcurl_close()でリソースが解放されます。サンプルコードの利用例では、実際のプロキシ情報と検証用のURLを設定して動作確認を行うことができます。