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

Copy
1<?php
2
3/**
4 * cURLリクエストを実行し、DNS解決に特定のネットワークインターフェースを指定します。
5 *
6 * この関数は、CURLOPT_DNS_INTERFACE を使用してDNSクエリを特定のインターフェース
7 * (例: "eth0", "lo") 経由で送信する方法と、CURLOPT_DNS_USE_GLOBAL_CACHE を使用して
8 * グローバルDNSキャッシュの利用を制御する方法を示します。
9 *
10 * @param string $url リクエストを行うURL。
11 * @param string|null $dnsInterface DNS解決に使用するネットワークインターフェース名。
12 *                                  nullの場合、システムのデフォルトインターフェースが使用されます。
13 *                                  例: "eth0", "lo", "en0"。
14 * @param bool $useGlobalDnsCache この転送でグローバルDNSキャッシュを使用するかどうか。
15 *                                falseに設定すると、キャッシュをスキップして常に新しいDNSルックアップを実行します。
16 * @return string|false cURLリクエストのレスポンス本文、または失敗した場合はfalse。
17 */
18function performDnsSpecificCurlRequest(
19    string $url,
20    ?string $dnsInterface = null,
21    bool $useGlobalDnsCache = true
22): string|false {
23    // cURLセッションを初期化します。
24    $ch = curl_init();
25
26    if ($ch === false) {
27        error_log("cURLセッションの初期化に失敗しました。");
28        return false;
29    }
30
31    // 基本的なcURLオプションを設定します。
32    curl_setopt($ch, CURLOPT_URL, $url);
33    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 実行結果を文字列として返します。
34    curl_setopt($ch, CURLOPT_FAILONERROR, true); // HTTPステータスコードが400以上の場合にエラーとします。
35
36    // CURLOPT_DNS_INTERFACE 定数を設定します。
37    // これは、DNSクエリの送信元となるネットワークインターフェースを指定します。
38    if ($dnsInterface !== null) {
39        curl_setopt($ch, CURLOPT_DNS_INTERFACE, $dnsInterface);
40    }
41
42    // CURLOPT_DNS_USE_GLOBAL_CACHE オプションを設定します。
43    // このオプションは、このcURLハンドルがグローバルDNSキャッシュを使用するかどうかを制御します。
44    // falseに設定すると、このリクエストのためにDNSが再解決されます。
45    curl_setopt($ch, CURLOPT_DNS_USE_GLOBAL_CACHE, $useGlobalDnsCache);
46
47    // cURLリクエストを実行します。
48    $response = curl_exec($ch);
49
50    // エラーが発生した場合の処理
51    if (curl_errno($ch)) {
52        error_log('cURLエラー (' . curl_errno($ch) . '): ' . curl_error($ch));
53        $response = false;
54    }
55
56    // cURLセッションを閉じ、リソースを解放します。
57    curl_close($ch);
58
59    return $response;
60}
61
62// -----------------------------------------------------------------------------
63// サンプルコードの実行例 (このコードを実行するとコンソールに出力されます)
64// -----------------------------------------------------------------------------
65
66// テスト用のURLを指定します。実際のウェブサイトを頻繁にテストしないように注意してください。
67$testUrl = "https://www.example.com";
68
69echo "--- デフォルト設定 (インターフェース指定なし、グローバルキャッシュ使用) ---\n";
70$resultDefault = performDnsSpecificCurlRequest($testUrl);
71if ($resultDefault !== false) {
72    echo "成功: レスポンス長 " . strlen($resultDefault) . "バイト\n\n";
73    // echo "レスポンスの一部:\n" . substr($resultDefault, 0, 200) . "...\n\n"; // レスポンスの一部を表示する場合
74} else {
75    echo "リクエストに失敗しました。\n\n";
76}
77
78// ループバックインターフェース 'lo' をDNS解決に使用し、グローバルキャッシュを使用しない例。
79// 注意: 実際のシステムで 'lo' インターフェースがDNS解決に利用可能であるとは限りません。
80// 不適切なインターフェース名を指定するとエラーになる可能性があります。
81echo "--- DNSインターフェースに 'lo' を指定し、グローバルキャッシュを使用しない場合 ---\n";
82$resultLoNoCache = performDnsSpecificCurlRequest($testUrl, "lo", false);
83if ($resultLoNoCache !== false) {
84    echo "成功: レスポンス長 " . strlen($resultLoNoCache) . "バイト\n\n";
85} else {
86    echo "リクエストに失敗しました。(存在しないインターフェースや設定によっては失敗します。)\n\n";
87}
88
89// DNSインターフェースは指定せず、グローバルキャッシュのみを使用しない例。
90echo "--- DNSインターフェース指定なし、グローバルキャッシュを使用しない場合 ---\n";
91$resultNoInterfaceNoCache = performDnsSpecificCurlRequest($testUrl, null, false);
92if ($resultNoInterfaceNoCache !== false) {
93    echo "成功: レスポンス長 " . strlen($resultNoInterfaceNoCache) . "バイト\n\n";
94} else {
95    echo "リクエストに失敗しました。\n\n";
96}

このPHPサンプルコードは、cURLを使ってHTTPリクエストを行う際に、DNS（ドメイン名システム）の名前解決を特定のネットワークインターフェース経由で実行する方法を示しています。CURLOPT_DNS_INTERFACE定数を使用することで、例えば「eth0」や「lo」といったネットワークインターフェース名を指定し、そのインターフェースからDNSクエリを送信できます。これにより、複数のネットワークインターフェースを持つシステムにおいて、DNS解決の経路を明示的に制御することが可能になります。

また、関連するCURLOPT_DNS_USE_GLOBAL_CACHEオプションも設定されており、このcURLリクエストがPHPのグローバルDNSキャッシュを使用するかどうかを制御できます。このオプションをfalseに設定すると、キャッシュをスキップして常に新しいDNSルックアップが実行されます。

関数performDnsSpecificCurlRequestは、引数としてリクエスト先の$url、DNS解決に使用する$dnsInterface名（省略可能）、そしてグローバルDNSキャッシュを使用するかどうかの$useGlobalDnsCacheを受け取ります。成功時にはウェブサイトのレスポンス本文を文字列として返し、失敗時にはfalseを返します。この機能は、ネットワーク診断や特定のネットワーク環境下でのテストに役立ちます。

Copy
1<?php
2
3/**
4 * 指定されたURLに対してcURLリクエストを送信し、
5 * DNS解決に特定のローカルインターフェースまたはIPアドレスを使用します。
6 *
7 * この関数は、PHPのcURL拡張における `CURLOPT_DNS_INTERFACE` オプションの使用例を示します。
8 * このオプションは、DNSクエリが特定のネットワークインターフェース、
9 * または指定されたローカルIPアドレスから発信されるように制御するために使用されます。
10 *
11 * @param string $url リクエストを送信するターゲットURL。
12 * @param string $dnsInterface DNS解決に使用するローカルインターフェース名またはIPアドレス。
13 *                              例: "eth0" (ネットワークインターフェース名)
14 *                              例: "192.168.1.100" (ローカルIPv4アドレス)
15 *                              例: "2001:db8::1" (ローカルIPv6アドレス)
16 * @return string|false リクエストの応答ボディ。エラーが発生した場合は `false` を返します。
17 */
18function fetchDataWithCustomDnsInterface(string $url, string $dnsInterface): string|false
19{
20    // cURL セッションを初期化します。
21    $ch = curl_init();
22
23    if ($ch === false) {
24        // cURLの初期化に失敗した場合、エラーメッセージを出力し、処理を終了します。
25        echo 'エラー: cURL の初期化に失敗しました。PHPのcURL拡張が有効になっているか確認してください。' . PHP_EOL;
26        return false;
27    }
28
29    // cURL オプションを設定します。
30
31    // 1. アクセスするURLを設定します。
32    curl_setopt($ch, CURLOPT_URL, $url);
33
34    // 2. サーバーからの応答を文字列として取得するように設定します。
35    //    このオプションがない場合、`curl_exec` は直接出力します。
36    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
37
38    // 3. DNSクエリを送信する際に使用するローカルインターフェース名またはIPアドレスを指定します。
39    //    これにより、DNSリクエストが特定のネットワークアダプタや特定のローカルIPアドレスから
40    //    発信されるように強制できます。
41    curl_setopt($ch, CURLOPT_DNS_INTERFACE, $dnsInterface);
42
43    // 4. HTTPステータスコードが400以上の場合にエラーとして処理するよう設定します。
44    //    これにより、HTTPエラーコードが返された場合も `curl_exec` が `false` を返します。
45    curl_setopt($ch, CURLOPT_FAILONERROR, true);
46
47    // 5. SSL証明書の検証を無効にします。
48    //    注意: これは開発環境でのテストや特定の状況でのみ使用してください。
49    //    本番環境ではセキュリティリスクが高いため、証明書検証を有効にすることを強く推奨します。
50    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
51    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
52
53    // cURL セッションを実行し、サーバーからの応答を取得します。
54    $response = curl_exec($ch);
55
56    // cURL 実行中にエラーが発生した場合は、エラーメッセージを表示します。
57    if (curl_errno($ch)) {
58        echo 'cURL エラー: ' . curl_error($ch) . PHP_EOL;
59        $response = false;
60    }
61
62    // cURL セッションを閉じ、使用していたリソースを解放します。
63    curl_close($ch);
64
65    return $response;
66}
67
68// --- サンプルコードの実行例 ---
69
70// ターゲットとなるURLを設定します。
71// 実際に存在する公開されたウェブサイトのURLを指定してください。
72$targetUrl = 'https://www.example.com';
73
74// DNS解決に使用するローカルインターフェース名またはIPアドレスを指定します。
75//
76// 重要: この値は、あなたのPCやサーバーのネットワーク設定に依存します。
77//      存在しないインターフェース名や有効ではないIPアドレスを指定すると、
78//      DNS解決が失敗し、cURLエラーが発生する可能性があります。
79//      ご自身の環境で実際に有効な値に置き換えて使用してください。
80//
81// 例1: ローカルのIPv4アドレスを指定する (一般的な使用例)
82//      この例では、架空のローカルIPアドレスを設定しています。
83$myDnsInterface = '192.168.1.100'; // <-- この値をあなたの環境に合わせて変更してください
84
85// 例2: ローカルのIPv6アドレスを指定する (コメントを解除して使用する場合)
86//      例えば、IPv6ループバックアドレス '::1' や、ネットワーク内の特定のIPv6アドレス。
87// $myDnsInterface = '::1';
88// $myDnsInterface = '2001:db8::1'; // 架空のIPv6アドレス。実際に使うには設定が必要です。
89
90// 例3: ネットワークインターフェース名を指定する (コメントを解除して使用する場合)
91//      例えば、Linux環境では 'eth0'、macOS環境では 'en0' など。
92// $myDnsInterface = 'eth0';
93
94
95echo "--- cURL リクエスト開始 ---" . PHP_EOL;
96echo "ターゲットURL: {$targetUrl}" . PHP_EOL;
97echo "DNS解決に使用するインターフェース/IPアドレス: {$myDnsInterface}" . PHP_EOL . PHP_EOL;
98
99$data = fetchDataWithCustomDnsInterface($targetUrl, $myDnsInterface);
100
101if ($data !== false) {
102    echo "データ取得成功！" . PHP_EOL;
103    echo "--- 応答の最初の100文字 ---" . PHP_EOL;
104    // 取得したデータの最初の100文字を表示します。
105    // HTMLタグが含まれる可能性があるため、表示前にエスケープ処理を適用しています。
106    echo htmlspecialchars(substr($data, 0, 100)) . "..." . PHP_EOL;
107    echo "---------------------------" . PHP_EOL;
108} else {
109    echo "データ取得失敗。上記のエラーメッセージを確認してください。" . PHP_EOL;
110}
111echo PHP_EOL . "--- cURL リクエスト終了 ---" . PHP_EOL;
112

このPHPサンプルコードは、cURL拡張機能で利用できるCURLOPT_DNS_INTERFACEオプションの使い方を説明しています。このオプションは、Webサイトのドメイン名からIPアドレスを解決するDNSクエリを、特定のネットワークインターフェースやローカルIPアドレスから発信するように指定するために使用されます。通常、システムはDNSクエリに最適なネットワーク経路を自動選択しますが、このオプションを使用することで、例えば複数のネットワークカードを持つサーバーにおいて、特定の経路を通してDNS解決を行わせたい場合に役立ちます。

fetchDataWithCustomDnsInterface関数は、リクエストを送信するターゲットURLと、DNS解決に使用したいローカルインターフェース名またはIPアドレス（IPv4またはIPv6）を引数に受け取ります。関数内部では、cURLセッションを初期化し、指定されたURLとCURLOPT_DNS_INTERFACEオプションを設定してHTTPリクエストを実行します。これにより、DNSクエリが指定されたインターフェースやIPアドレス経由で送信されるようになります。引数$urlはアクセスするURL、$dnsInterfaceはDNS解決に使うインターフェース名またはローカルIPアドレスです。戻り値は、リクエスト成功時にサーバーからの応答ボディを文字列で返し、エラーが発生した場合はfalseを返します。この機能を使う際は、指定するインターフェース名やIPアドレスが、実行環境に実際に存在し有効なものである必要があります。