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

Copy
1<?php
2
3/**
4 * 指定されたホスト名のすべてのDNSレコードを取得し、分かりやすく表示します。
5 *
6 * DNS_ANY定数を使用することで、A (IPv4アドレス), AAAA (IPv6アドレス), MX (メール交換),
7 * NS (ネームサーバー), SOA (権威の開始), TXT (テキスト) など、あらゆる種類のDNSレコードを取得します。
8 *
9 * @param string $hostname 問い合わせるホスト名 (例: "example.com")
10 * @return void
11 */
12function display_all_dns_records(string $hostname): void
13{
14    echo "--- ホスト名: '{$hostname}' のDNSレコード取得 --- \n";
15
16    // dns_get_record関数を使って、指定されたホスト名のDNSレコードを取得します。
17    // 第二引数にDNS_ANYを指定することで、すべての利用可能なレコードタイプを取得します。
18    // DNS_ANY は、PHPのDNS拡張機能で定義されている定数の一つで、
19    // すべてのレコードタイプ（A, MX, NS, SOA, TXTなど）を問い合わせることを意味します。
20    $records = dns_get_record($hostname, DNS_ANY);
21
22    if ($records === false) {
23        echo "エラー: ホスト名 '{$hostname}' のDNSレコードを取得できませんでした。\n";
24        echo "ホスト名が正しいか、またはDNSサーバーへの接続を確認してください。\n";
25        return;
26    }
27
28    if (empty($records)) {
29        echo "情報: '{$hostname}' のDNSレコードは見つかりませんでした。\n";
30        return;
31    }
32
33    echo "取得されたレコード数: " . count($records) . "\n";
34    echo "---------------------------------------------------\n";
35
36    foreach ($records as $index => $record) {
37        echo "レコード #" . ($index + 1) . ":\n";
38        echo "  タイプ: " . ($record['type'] ?? '不明') . "\n";
39        echo "  ホスト: " . ($record['host'] ?? '不明') . "\n";
40        echo "  TTL (秒): " . ($record['ttl'] ?? '不明') . "\n";
41
42        // 主要なレコードタイプごとに具体的な情報を表示
43        switch ($record['type']) {
44            case 'A': // IPv4アドレス
45                echo "  IPアドレス (IPv4): " . ($record['ip'] ?? 'N/A') . "\n";
46                break;
47            case 'AAAA': // IPv6アドレス
48                echo "  IPアドレス (IPv6): " . ($record['ipv6'] ?? 'N/A') . "\n";
49                break;
50            case 'MX': // メール交換レコード
51                echo "  優先度: " . ($record['pri'] ?? 'N/A') . "\n";
52                echo "  メールサーバー: " . ($record['target'] ?? 'N/A') . "\n";
53                break;
54            case 'NS': // ネームサーバーレコード
55                echo "  ネームサーバー: " . ($record['target'] ?? 'N/A') . "\n";
56                break;
57            case 'TXT': // テキストレコード
58                echo "  テキストデータ: " . ($record['txt'] ?? 'N/A') . "\n";
59                break;
60            case 'CNAME': // Canonical Name (エイリアス) レコード
61                echo "  エイリアスターゲット: " . ($record['target'] ?? 'N/A') . "\n";
62                break;
63            // その他のレコードタイプも存在しますが、ここでは主要なものを抜粋して表示しています。
64        }
65        echo "---------------------------------------------------\n";
66    }
67}
68
69// 実際に関数を実行してDNSレコードを取得する例
70// ここでは一般的なウェブサイトである google.com のDNSレコードを取得します。
71$targetHost = "google.com";
72display_all_dns_records($targetHost);
73
74// 他のホスト名で試す場合は、以下のコメントを外して実行してください。
75// $anotherHost = "php.net";
76// display_all_dns_records($anotherHost);
77
78// 存在しないホスト名でエラーがどのように表示されるかを確認する例。
79// $nonExistentHost = "nonexistent-domain-example-xyz123.com";
80// display_all_dns_records($nonExistentHost);
81
82?>

このPHPコードは、ウェブサイトなどのインターネット上の住所（IPアドレス）を調べる「名前解決」の仕組みであるDNS（Domain Name System）の情報を取得する方法を示しています。特にDNS_ANY定数を使用することで、指定されたホスト名（例: "google.com"）に関するAレコード（IPv4アドレス）、AAAAレコード（IPv6アドレス）、MXレコード（メールサーバー）、NSレコード（ネームサーバー）など、あらゆる種類のDNSレコードをまとめて取得できます。

サンプルコードのdisplay_all_dns_records関数は、引数として問い合わせたい$hostname（文字列型）を受け取ります。この関数内部では、PHPの組み込み関数であるdns_get_recordが利用され、第二引数にDNS_ANY定数を渡すことで、指定ホスト名の利用可能な全てのDNSレコードを取得します。取得したレコードは配列として返され、関数はそれらを一つずつ処理し、レコードの種類や内容、生存期間（TTL）などを分かりやすく画面に表示します。レコードの取得に失敗した場合や、レコードが見つからない場合は、その旨を通知します。この関数は画面に情報を出力するだけで、直接的な値を返さないため、戻り値はvoidです。本コードはPHPバージョン8以降で動作し、DNSに関する基本的な情報収集を行う際に役立ちます。

Copy
1<?php
2
3/**
4 * 指定されたホスト名に対するすべてのDNSレコードを取得し、表示します。
5 * システムエンジニアを目指す初心者向けに、DNS_ANY定数の使い方を示します。
6 *
7 * @param string $hostname 検索するホスト名（例: "example.com"）
8 * @return void
9 */
10function displayAllDnsRecords(string $hostname): void
11{
12    echo "--- DNSレコード検索 ---" . PHP_EOL;
13    echo "対象ホスト名: " . $hostname . PHP_EOL . PHP_EOL;
14
15    // DNS_ANY は、指定されたホスト名に対するA、MX、NSなど、
16    // すべてのタイプのDNSレコードを検索するための定数です。
17    // dns_get_record() 関数に渡すことで、広範囲のレコードを取得できます。
18    $records = dns_get_record($hostname, DNS_ANY);
19
20    if ($records === false) {
21        echo "エラー: ホスト名「" . $hostname . "」のDNSレコードを取得できませんでした。" . PHP_EOL;
22        echo "DNSサーバーの設定やネットワーク接続を確認してください。" . PHP_EOL;
23        return;
24    }
25
26    if (empty($records)) {
27        echo "ホスト名「" . $hostname . "」に対するDNSレコードは見つかりませんでした。" . PHP_EOL;
28        return;
29    }
30
31    echo count($records) . "件のDNSレコードが見つかりました:" . PHP_EOL;
32    foreach ($records as $index => $record) {
33        echo "--- レコード #" . ($index + 1) . " ---" . PHP_EOL;
34        foreach ($record as $key => $value) {
35            // 配列形式の値を扱うためにjson_encodeを使用（例: MXレコードのtargetなど）
36            $displayValue = is_array($value) ? json_encode($value, JSON_UNESCAPED_UNICODE) : $value;
37            echo sprintf("  %-10s: %s" . PHP_EOL, $key, $displayValue);
38        }
39    }
40    echo "--- 検索終了 ---" . PHP_EOL;
41}
42
43// 実際に存在するドメイン名を使って動作を確認します。
44// 例: "google.com", "php.net", "example.com"
45$targetHostname = "php.net";
46
47// 関数を呼び出してDNSレコードを表示
48displayAllDnsRecords($targetHostname);
49
50?>

このPHPサンプルコードは、指定されたホスト名に対するすべてのDNSレコードを取得し、表示する方法を示しています。DNS_ANYは、Aレコード（IPアドレス）、MXレコード（メールサーバー）、NSレコード（ネームサーバー）など、あらゆる種類のDNSレコードを一度に検索したいときに使用する定数です。

displayAllDnsRecords関数は、検索対象のホスト名（例: "example.com"）を文字列型の引数$hostnameとして受け取ります。関数内部では、dns_get_record()関数にこの$hostnameとDNS_ANY定数を渡すことで、指定されたドメインのすべてのDNSレコード情報を取得します。取得されたレコードは配列として返され、その内容を一つずつ整形して画面に表示します。

もしdns_get_record()の呼び出しが失敗した場合や、指定されたホスト名に対するレコードが見つからなかった場合には、その旨を示すメッセージが出力されます。この関数は、処理結果を直接返すのではなく、情報を画面に出力するのみのため、戻り値はvoid（何も返さない）と定義されています。このコードを通じて、ドメイン名がどのように様々なインターネットサービスに紐づけられているかの仕組みを具体的に理解することができます。