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

Copy
1<?php
2
3/**
4 * 指定されたホスト名のIPv6 (AAAA) DNSレコードを取得し、表示します。
5 * DNS_AAAA 定数は、IPv6アドレス（AAAAレコード）の検索を指定するために使用されます。
6 *
7 * @param string $hostname 問い合わせるホスト名（例: "example.com"）
8 * @return array|false DNSレコードの配列、または操作が失敗した場合は false を返します。
9 */
10function get_ipv6_dns_records(string $hostname): array|false
11{
12    echo "ホスト名 '{$hostname}' のIPv6 (AAAA) DNSレコードを検索中...\n";
13
14    // dns_get_record() 関数を使用して、指定されたホスト名のAAAAレコードを検索します。
15    // 第二引数に DNS_AAAA 定数を指定することで、IPv6アドレス (AAAAレコード) のみを要求します。
16    $records = dns_get_record($hostname, DNS_AAAA);
17
18    // dns_get_record() が false を返した場合、DNS問い合わせ自体に失敗しています。
19    if ($records === false) {
20        echo "エラー: ホスト名 '{$hostname}' のDNSレコードを取得できませんでした。\n";
21        return false;
22    }
23
24    // レコードが空の場合、指定されたタイプのレコードが見つからなかったことを意味します。
25    if (empty($records)) {
26        echo "ホスト名 '{$hostname}' にはIPv6 (AAAA) DNSレコードが見つかりませんでした。\n";
27        return [];
28    }
29
30    echo "ホスト名 '{$hostname}' のIPv6 (AAAA) DNSレコード:\n";
31    foreach ($records as $record) {
32        // 各レコードから主要な情報を抽出して表示します。
33        // 'ipv6' キーにはIPv6アドレスが含まれます。
34        echo "  - ホスト名: " . ($record['host'] ?? 'N/A') . "\n";
35        echo "    タイプ: " . ($record['type'] ?? 'N/A') . "\n";
36        echo "    クラス: " . ($record['class'] ?? 'N/A') . "\n";
37        echo "    TTL: " . ($record['ttl'] ?? 'N/A') . "秒\n";
38        echo "    IPv6アドレス: " . ($record['ipv6'] ?? 'N/A') . "\n";
39        echo "----------------------------------------\n";
40    }
41
42    return $records;
43}
44
45// --- サンプルコードの実行 ---
46// 任意のホスト名を指定して、関数を呼び出します。
47$targetHostname = "google.com";
48
49// 関数を実行し、結果を表示します。
50get_ipv6_dns_records($targetHostname);
51
52// 他のホスト名を試す場合（コメントを外して実行してください）
53// $anotherHostname = "example.com";
54// get_ipv6_dns_records($anotherHostname);
55
56?>

このPHPサンプルコードは、指定したホスト名（ウェブサイトの名前）に対応するIPv6アドレス（AAAAレコード）の情報を取得し、表示する方法を示しています。DNS_AAAA定数は、PHPのdns_get_record関数を使用してDNS（ドメイン名システム）に問い合わせを行う際に、特にIPv6アドレスのレコードのみを検索対象とするよう指定するために用いられます。

get_ipv6_dns_records関数は、引数として検索対象のホスト名（例: "google.com"）を受け取ります。関数内部では、dns_get_record関数がこのホスト名とDNS_AAAA定数を使い、DNSサーバーへ問い合わせを行います。これにより、ホスト名に対応するIPv6アドレスやその他の詳細情報が含まれたレコードが取得されます。

戻り値は、取得できたDNSレコードの配列です。この配列には、ホスト名、レコードタイプ、TTL（有効期間）、そして最も重要なIPv6アドレスなどの情報が含まれます。もし指定されたホスト名に対してIPv6レコードが見つからなければ空の配列を、DNS問い合わせ自体に失敗した場合はfalseを返します。取得されたIPv6アドレスの情報は、ホスト名、IPv6アドレス、タイプ、TTLなどの詳細とともに画面に表示されます。

このコードは、ウェブサイトがどのIPv6アドレスで提供されているかを確認し、ネットワークにおける名前解決の仕組みを理解する一助となります。

Copy
1<?php
2
3/**
4 * PHPのDNS_AAAA定数を使用して、特定のドメインのIPv6 (AAAA) DNSレコードを取得し表示します。
5 *
6 * この関数は、システムエンジニアの初心者がPHPでDNS情報を取得する方法を理解するのに役立ちます。
7 * DNS_AAAA定数は、dns_get_record()関数の引数として使用され、
8 * IPv6アドレスレコード（AAAAレコード）のみを取得するよう指定します。
9 *
10 * @param string $domain レコードを取得したいドメイン名。
11 */
12function getIpv6DnsRecordsForDomain(string $domain): void
13{
14    echo "ドメイン '{$domain}' のIPv6 (AAAA) DNSレコードを取得中...\n";
15
16    // dns_get_record() 関数を使用してDNSレコードを取得します。
17    // DNS_AAAA定数を指定することで、IPv6アドレスレコードのみをフィルタリングします。
18    $records = dns_get_record($domain, DNS_AAAA);
19
20    if ($records === false) {
21        // DNSレコードの取得に失敗した場合のエラー処理
22        echo "エラー: DNSレコードの取得に失敗しました。ドメイン名やDNS設定を確認してください。\n";
23    } elseif (empty($records)) {
24        // IPv6 (AAAA) レコードが見つからなかった場合
25        echo "ドメイン '{$domain}' にはIPv6 (AAAA) レコードが見つかりませんでした。\n";
26    } else {
27        // IPv6 (AAAA) レコードが見つかった場合、その詳細を表示します。
28        echo "見つかったIPv6 (AAAA) レコード:\n";
29        foreach ($records as $record) {
30            // 'ipv6' キーにはIPv6アドレスが格納されています。
31            echo "  - ホスト: {$record['host']}, IPv6アドレス: {$record['ipv6']}, TTL: {$record['ttl']}秒\n";
32        }
33    }
34}
35
36// 例として 'google.com' のIPv6 (AAAA) レコードを取得してみましょう。
37// 実際に実行する際は、ご自身の確認したいドメイン名に置き換えてください。
38$targetDomain = "google.com";
39getIpv6DnsRecordsForDomain($targetDomain);
40
41?>

PHP 8のDNS_AAAA定数は、PHPのextentionとして提供される特別な値で、DNSレコードの種類の中でもIPv6アドレスを示す「AAAAレコード」を指定する際に使用されます。この定数自体は引数を取らず、特定の値を返しません。

このサンプルコードは、DNS_AAAA定数を活用し、システムエンジニアを目指す初心者がPHPで特定のドメインのIPv6 DNSレコードを取得し表示する方法を理解できるように作られています。getIpv6DnsRecordsForDomain関数は、レコードを取得したいドメイン名を$domainという文字列型の引数として受け取ります。この関数は処理結果を画面に出力するため、特定の戻り値は設定されていません（void）。

関数内では、dns_get_record()関数が使用されており、第一引数にターゲットのドメイン名、第二引数にDNS_AAAA定数を指定することで、IPv6アドレスレコードのみを効率的にフィルタリングして取得します。取得したレコードは$records変数に格納され、レコードの取得に失敗した場合、またはIPv6レコードが見つからなかった場合、そしてレコードが正常に見つかった場合のそれぞれに応じたメッセージを分かりやすく表示します。これにより、PHPでのDNS情報取得の基本的な流れと、取得結果の確認方法を実践的に学ぶことができます。