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

Copy
1<?php
2
3/**
4 * 指定されたドメインのすべてのDNSレコードを取得し、表示します。
5 *
6 * @param string $domain レコードを取得するドメイン名（例: "example.com"）。
7 * @return void
8 */
9function getDomainDnsRecords(string $domain): void
10{
11    echo "--- ドメイン: {$domain} のDNSレコードを取得中 ---\n";
12
13    // dns_get_record 関数を使用して、指定されたドメインのDNSレコードを取得します。
14    // 第2引数に DNS_ALL 定数を指定することで、すべての種類のレコード (A, MX, NSなど) を取得します。
15    // PHP 8 では、内部的に IPv6 (AAAA) レコードも自動的に取得対象に含まれます。
16    $records = dns_get_record($domain, DNS_ALL);
17
18    if ($records === false) {
19        // DNSレコードの取得に失敗した場合
20        echo "エラー: '{$domain}' のDNSレコードを取得できませんでした。\n";
21        echo "ドメイン名が正しいか、DNSサーバーに到達可能か確認してください。\n";
22        return;
23    }
24
25    if (empty($records)) {
26        // レコードが見つからなかった場合
27        echo "情報: '{$domain}' のDNSレコードは見つかりませんでした。\n";
28        return;
29    }
30
31    echo "--- 取得されたDNSレコード ---\n";
32    // 取得したレコードを整形して表示します。
33    // 各レコードは連想配列として含まれています。
34    print_r($records);
35
36    echo "--- レコード取得完了 ---\n";
37}
38
39// サンプルとして、GoogleのドメインのDNSレコードを取得してみます。
40// このコードを実行すると、コンソールにGoogleのDNSレコード情報が出力されます。
41getDomainDnsRecords("google.com");
42
43echo "\n";
44
45// 存在しない可能性のあるドメインでエラーケースを試す場合
46// getDomainDnsRecords("nonexistent-domain-12345.com");
47
48?>

このサンプルコードは、PHPのdns_get_record関数とDNS_ALL定数を利用して、指定されたドメインのすべてのDNSレコードを取得し、その内容をコンソールに表示するものです。

getDomainDnsRecords関数は、引数としてDNSレコードを取得したいドメイン名（文字列型）を受け取ります。この関数内でdns_get_record関数が呼び出されており、第1引数に受け取ったドメイン名、第2引数にDNS_ALL定数が指定されています。DNS_ALL定数を指定することで、Aレコード（IPv4アドレス）、AAAAレコード（IPv6アドレス）、MXレコード（メールサーバー情報）、NSレコード（ネームサーバー情報）など、そのドメインに関連するすべての種類のDNSレコードを一括で取得できます。特にPHP 8では、DNS_ALL定数を使用するとIPv6 (AAAA) レコードも自動的に取得対象に含まれる点が特徴です。

dns_get_record関数は、レコードの取得に成功した場合、それぞれのレコード情報を連想配列として格納した配列を戻り値として返します。サンプルコードでは、この取得したレコード情報をprint_r関数を使って整形し、コンソールに分かりやすく表示しています。もしレコードの取得に失敗した場合はfalseが、レコードが見つからない場合は空の配列が返されるため、それぞれの場合に応じたエラーメッセージや情報メッセージが表示されるように処理が実装されています。getDomainDnsRecords関数自体の戻り値はvoidであり、直接値を返さず、処理結果を標準出力に表示する役割を持っています。

システムエンジニアにとって、ウェブサイトの公開状況やメールの送受信設定など、ネットワーク関連の確認やトラブルシューティングを行う際に、ドメインの基本情報を素早く把握するためにこの機能は非常に役立ちます。

Copy
1<?php
2
3/**
4 * 指定されたドメイン名のすべてのDNSレコードを解決し、その結果を表示します。
5 *
6 * この関数はPHPの `dns_get_record()` 関数を使用し、
7 * 第二引数に `DNS_ALL` 定数を渡すことで、指定されたドメインの
8 * Aレコード、AAAAレコード、MXレコード、NSレコード、TXTレコードなど、
9 * 利用可能なすべての種類のDNSリソースレコードを取得します。
10 *
11 * @param string $domain 解決したいドメイン名（例: "example.com" や "google.com"）
12 * @return void
13 */
14function resolveAllDnsRecords(string $domain): void
15{
16    echo "ドメイン '{$domain}' のすべてのDNSレコードを解決しています...\n\n";
17
18    // dns_get_record 関数を使い、DNS_ALL 定数で全てのレコードタイプを問い合わせます。
19    // DNS_ALL は、A, AAAA, MX, NS, SOA, TXT など、すべての標準的なDNSレコードタイプを含みます。
20    // 解決に失敗した場合やレコードが見つからない場合は、空の配列を返します。
21    $records = dns_get_record($domain, DNS_ALL);
22
23    if (empty($records)) {
24        echo "エラー: ドメイン '{$domain}' のDNSレコードが見つからないか、解決に失敗しました。\n";
25        return;
26    }
27
28    echo "=== '{$domain}' のDNSレコード結果 ===\n";
29    foreach ($records as $record) {
30        echo "  タイプ: {$record['type']}\n";
31        echo "  ホスト: {$record['host']}\n";
32        echo "  TTL: {$record['ttl']}秒\n"; // Time To Live: レコードがキャッシュされる時間
33
34        // レコードタイプによって存在する一般的なフィールドを表示します。
35        // すべてのレコードにこれらのフィールドが存在するわけではありません。
36        if (isset($record['ip'])) {
37            echo "  IPアドレス (IPv4): {$record['ip']}\n";
38        }
39        if (isset($record['ipv6'])) {
40            echo "  IPアドレス (IPv6): {$record['ipv6']}\n";
41        }
42        if (isset($record['pri'])) { // MXレコードの優先度 (Priority)
43            echo "  優先度: {$record['pri']}\n";
44        }
45        if (isset($record['target'])) { // MX, NS, CNAMEレコードなどのターゲットホスト名
46            echo "  ターゲット: {$record['target']}\n";
47        }
48        if (isset($record['txt'])) { // TXTレコードのデータ
49            echo "  TXTデータ: {$record['txt']}\n";
50        }
51        echo "  --------------------------\n";
52    }
53}
54
55// --- 使用例 ---
56// 実際に存在するドメイン名（例: "google.com" や "php.net"）を指定すると、
57// より多くの種類のDNSレコード結果を確認できます。
58$targetDomain = "example.com";
59resolveAllDnsRecords($targetDomain);
60
61echo "\n--- 別のドメインで試すこともできます ---\n";
62$anotherDomain = "google.com";
63resolveAllDnsRecords($anotherDomain);
64
65?>

このPHPコードは、指定されたドメイン名のすべてのDNS（Domain Name System）レコードを解決し、その詳細を表示するためのものです。DNSは、ウェブサイトのアドレス（ドメイン名）をインターネット上のサーバーの数値アドレス（IPアドレス）に変換する、インターネットの基本的な仕組みの一つです。

コードの核となるのは、PHPのdns_get_record()関数と、DNS_ALLという定数です。dns_get_record()関数は、特定のドメインに関連付けられたDNSレコードを問い合わせるために使用されます。ここで第二引数にDNS_ALL定数を指定することで、Aレコード（IPv4アドレス）、AAAAレコード（IPv6アドレス）、MXレコード（メールサーバー情報）、NSレコード（ネームサーバー情報）、TXTレコード（テキスト情報）など、そのドメインに設定されているすべての種類のDNSリソースレコードを一度に取得することができます。

サンプルコード内のresolveAllDnsRecords関数は、引数として受け取った$domain（解決したいドメイン名）に対してdns_get_record()を実行し、取得した各レコードの情報（タイプ、ホスト名、TTL、IPアドレス、優先度など）を整形して画面に出力します。この関数は結果を直接返すのではなく、画面に表示するだけの役割を持つため、戻り値はvoidと定義されています。ドメインのDNSレコードが見つからない場合や、何らかの理由で解決に失敗した場合には、エラーメッセージが表示されます。このサンプルは、システムがどのようにドメイン名を解決しているかを理解するための基本的な学習リソースとして役立ちます。