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

Copy
1<?php
2
3/**
4 * CURLOPT_RESOLVE オプションの使用例を示します。
5 *
6 * このオプションは、特定のホスト名を指定されたIPアドレスに解決するよう
7 * cURLに指示するために使用されます。これにより、DNSルックアップをスキップし、
8 * 強制的に特定のIPアドレスに接続を試みることができます。
9 * 主にテスト環境や、ホストとIPアドレスのマッピングを制御したい場合に利用されます。
10 */
11function demonstrateCurloptResolve(): void
12{
13    $ch = curl_init();
14
15    if ($ch === false) {
16        echo "cURLセッションの初期化に失敗しました。\n";
17        return;
18    }
19
20    // CURLOPT_RESOLVE オプションに設定する解決エントリの配列を定義します。
21    // 形式: ["ホスト名:ポート番号:IPアドレス"]
22    // ここでは 'example.com' のHTTP (ポート80) アクセスを
23    // 架空のプライベートIPアドレス '192.168.1.100' に解決するように指定しています。
24    // このIPアドレスは通常外部からアクセスできないため、接続は失敗する可能性がありますが、
25    // CURLOPT_RESOLVE の設定方法を示すためのものです。
26    $resolveEntries = [
27        "example.com:80:192.168.1.100",
28        // 複数のエントリを指定することも可能です。
29        // "test.example.com:443:192.168.1.101",
30    ];
31
32    // CURLOPT_RESOLVE オプションを設定します。
33    // cURLはこれ以降、'example.com' のDNSルックアップを行わず、
34    // 指定されたIPアドレス '192.168.1.100' に接続を試みます。
35    curl_setopt($ch, CURLOPT_RESOLVE, $resolveEntries);
36
37    // 接続を試みるURLを指定します。
38    // ここで指定するホスト名が CURLOPT_RESOLVE で解決指定したホスト名と一致する必要があります。
39    curl_setopt($ch, CURLOPT_URL, "http://example.com/");
40
41    // レスポンスを文字列として返すように設定します。
42    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
43
44    // cURLリクエストを実行します。
45    echo "CURLOPT_RESOLVE を使用して example.com (実際には192.168.1.100) にアクセスを試みます。\n";
46    $response = curl_exec($ch);
47
48    if (curl_errno($ch)) {
49        // エラーが発生した場合
50        echo "cURLエラーが発生しました: " . curl_error($ch) . "\n";
51    } else {
52        // 成功した場合 (この例では、通常は接続エラーになります)
53        echo "cURLリクエストが完了しました。\n";
54        echo "HTTPステータスコード: " . curl_getinfo($ch, CURLINFO_HTTP_CODE) . "\n";
55        // レスポンスの一部を表示
56        // echo "レスポンス:\n" . substr($response, 0, 500) . "...\n";
57    }
58
59    // cURLセッションを閉じ、リソースを解放します。
60    curl_close($ch);
61}
62
63// 関数を実行します。
64demonstrateCurloptResolve();

PHPのCURLOPT_RESOLVEは、cURL通信を行う際に、特定のホスト名をDNSサーバーに問い合わせず、事前に指定したIPアドレスに強制的に解決させるためのオプションです。これにより、プログラムでホスト名とIPアドレスのマッピングを直接制御できます。

このオプションは、curl_setopt()関数を用いて設定します。設定する値は、"ホスト名:ポート番号:IPアドレス"という形式の文字列を要素とする配列です。例えば、["example.com:80:192.168.1.100"]と指定すると、example.comのHTTP（ポート80）へのアクセスは、DNSルックアップをスキップし、強制的に192.168.1.100というIPアドレスへ接続を試みます。CURLOPT_RESOLVE自体に引数や戻り値はありませんが、この配列によってcURLの動作を変更します。

この機能は、主にシステムの開発やテスト環境において、特定のIPアドレスを持つサーバーへの接続を検証したい場合や、一時的にDNSの解決先を変更して動作確認を行いたい場合に大変有効です。サンプルコードでは、example.comを架空のプライベートIPアドレスに解決する例を示しており、CURLOPT_RESOLVEの具体的な設定方法を理解していただくことを目的としています。このプライベートIPアドレスは通常、外部からアクセスできないため、実際の接続は失敗する可能性がありますが、オプションの挙動を学ぶには適しています。