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

Copy
1<?php
2
3/**
4 * cURLを使用して指定されたURLにリクエストを送信し、
5 * 名前解決のIPプロトコルバージョンを強制するサンプル関数です。
6 *
7 * @param string $url リクエストを送信するURL。
8 * @param int $ipResolveOption IP解決オプション (例: CURL_IPRESOLVE_V4, CURL_IPRESOLVE_V6)。
9 * @return string|false リクエストの成功時にはレスポンス文字列、失敗時にはfalseを返します。
10 */
11function makeCurlRequestWithIpResolve(string $url, int $ipResolveOption): string|false
12{
13    // cURLセッションを初期化します。
14    $ch = curl_init();
15
16    if ($ch === false) {
17        echo "エラー: cURLセッションの初期化に失敗しました。\n";
18        return false;
19    }
20
21    // リクエスト先のURLを設定します。
22    curl_setopt($ch, CURLOPT_URL, $url);
23
24    // curl_exec() が結果を文字列として返すように設定します。
25    // これを設定しないと、結果は直接出力されます。
26    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
27
28    // HTTPステータスコードが400以上の場合にcURLエラーとして処理するように設定します。
29    curl_setopt($ch, CURLOPT_FAILONERROR, true);
30
31    // ★★★ ここが CURLOPT_IPRESOLVE の設定箇所です ★★★
32    // ホスト名を解決する際に使用するIPプロトコルのバージョンを強制します。
33    //
34    // 利用可能な定数:
35    //   CURL_IPRESOLVE_WHATEVER (デフォルト): IPv4とIPv6の両方を試します。
36    //   CURL_IPRESOLVE_V4: ホスト名をIPv4アドレスのみで解決するように強制します。
37    //   CURL_IPRESOLVE_V6: ホスト名をIPv6アドレスのみで解決するように強制します。
38    curl_setopt($ch, CURLOPT_IPRESOLVE, $ipResolveOption);
39
40    // cURLリクエストを実行します。
41    $response = curl_exec($ch);
42
43    // エラーが発生したかチェックします。
44    if (curl_errno($ch)) {
45        echo "cURLエラー (" . curl_errno($ch) . "): " . curl_error($ch) . "\n";
46        $response = false;
47    }
48
49    // cURLセッションを閉じ、リソースを解放します。
50    curl_close($ch);
51
52    return $response;
53}
54
55// --- サンプル使用例 ---
56$targetUrl = "https://example.com"; // ターゲットURL
57
58echo "--- IP解決にIPv4のみを強制 --- \n";
59$resultV4 = makeCurlRequestWithIpResolve($targetUrl, CURL_IPRESOLVE_V4);
60if ($resultV4 !== false) {
61    echo "IPv4でのリクエストに成功しました (一部抜粋):\n";
62    echo substr($resultV4, 0, 200) . "...\n\n"; // レスポンスが長いため、先頭200文字のみ表示
63} else {
64    echo "IPv4でのリクエストに失敗しました。\n\n";
65}
66
67echo "--- IP解決にIPv6のみを強制 --- \n";
68$resultV6 = makeCurlRequestWithIpResolve($targetUrl, CURL_IPRESOLVE_V6);
69if ($resultV6 !== false) {
70    echo "IPv6でのリクエストに成功しました (一部抜粋):\n";
71    echo substr($resultV6, 0, 200) . "...\n\n";
72} else {
73    // 実行環境によってはIPv6ネットワークが利用できないため、失敗することがあります。
74    echo "IPv6でのリクエストに失敗しました (環境によってはIPv6が利用できない場合があります)。\n\n";
75}
76
77echo "--- IP解決にデフォルト設定 (IPv4/IPv6両方試行) --- \n";
78$resultWhatever = makeCurlRequestWithIpResolve($targetUrl, CURL_IPRESOLVE_WHATEVER);
79if ($resultWhatever !== false) {
80    echo "デフォルト設定でのリクエストに成功しました (一部抜粋):\n";
81    echo substr($resultWhatever, 0, 200) . "...\n\n";
82} else {
83    echo "デフォルト設定でのリクエストに失敗しました。\n\n";
84}
85
86?>

このPHPサンプルコードは、cURLライブラリを利用してHTTPリクエストを送信する際、接続先のホスト名をIPアドレスに解決する際のプロトコル（IPv4またはIPv6）を指定する方法を解説しています。makeCurlRequestWithIpResolve関数は、$urlで指定されたアドレスへリクエストを送り、$ipResolveOption引数によりIP解決のプロトコルバージョンを制御します。

$ipResolveOptionには、主に三つの定数を指定できます。CURL_IPRESOLVE_V4はIPv4アドレスでの解決のみを強制し、CURL_IPRESOLVE_V6はIPv6アドレスでの解決のみを強制します。CURL_IPRESOLVE_WHATEVERはデフォルト設定であり、IPv4とIPv6の両方を試みて最適な方を選択します。このCURLOPT_IPRESOLVEオプションを設定することで、特定のネットワーク環境や互換性の問題に対応できるようになります。

関数はcURLセッションの初期化からオプション設定、リクエスト実行、セッションクローズまでの一連の流れを含んでいます。リクエストが成功した場合、サーバーからのレスポンスコンテンツを文字列として返します。エラーが発生した場合は、その旨を通知しfalseを戻り値として返します。特に、IPv6アドレス解決を強制する際は、実行環境がIPv6に対応しているか確認することが重要です。この設定は、ネットワーク通信の細かい挙動を制御したい場合に役立ちます。