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

Copy
1<?php
2
3/**
4 * 指定されたドメインのAレコード（IPv4アドレス）を取得して表示します。
5 * DNS_A 定数は、dns_get_record() 関数でAレコードのみをフィルタリングするために使用されます。
6 * システムエンジニアがドメインの基本的な設定（例: ウェブサイトのIPアドレス）を確認する際などに役立ちます。
7 *
8 * @param string $domainName 検索するドメイン名。例: 'example.com'
9 * @return void
10 */
11function getDomainARecords(string $domainName): void
12{
13    echo "--- ドメイン: '{$domainName}' のAレコード検索 ---\n";
14
15    // dns_get_record() 関数を使用してDNS情報を取得します。
16    // 第2引数に DNS_A 定数を指定することで、Aレコード（IPv4アドレス）のみを取得します。
17    // DNS_A は PHP の組み込み定数で、Aレコードタイプを指します。
18    $records = dns_get_record($domainName, DNS_A);
19
20    if ($records === false) {
21        // DNSサーバーへの問い合わせ自体が失敗した場合のエラーハンドリング
22        echo "エラー: DNSレコードの取得に失敗しました。ネットワーク接続やドメイン名を確認してください。\n";
23        return;
24    }
25
26    if (empty($records)) {
27        // Aレコードが見つからなかった場合
28        echo "情報: '{$domainName}' のAレコードは見つかりませんでした。\n";
29    } else {
30        echo "見つかったAレコード:\n";
31        foreach ($records as $record) {
32            // 取得したレコード配列には、'ip' キーにIPv4アドレスが格納されています。
33            echo "- IPアドレス: {$record['ip']}\n";
34            // 必要に応じて他の情報（TTLなど）も表示できますが、シンプルさを保つためIPアドレスのみ表示します。
35            // echo "  TTL (生存時間): {$record['ttl']}秒\n";
36        }
37    }
38    echo "--------------------------------------------------\n\n";
39}
40
41// サンプル使用例
42// 既存のドメインのAレコードを確認
43getDomainARecords('example.com');
44getDomainARecords('google.com');
45getDomainARecords('php.net');
46
47// 存在しない可能性のあるドメインの例（エラーハンドリングの確認）
48getDomainARecords('nonexistent-domain-1234567890.com');
49
50?>

このPHPサンプルコードは、指定されたドメインのAレコード、つまりIPv4アドレス情報を取得して表示するものです。DNS_AはPHPの組み込み定数であり、DNSレコードの中からAレコードタイプのみをフィルタリングする際に使用されます。これは、特定の種類のDNS情報を効率的に取得するために非常に重要です。

getDomainARecords関数は、引数として検索したいドメイン名（string $domainName）を受け取り、そのドメインのAレコードを検索します。この関数は具体的な値を返しません（void）が、見つかったIPv4アドレスを直接画面に出力します。関数内部では、dns_get_record()関数を使用しており、この関数の第2引数にDNS_A定数を渡すことで、指定されたドメインに関連付けられたIPv4アドレスのみを効率良く取得しています。もしAレコードが見つからない場合や、DNSサーバーへの問い合わせ自体が失敗した場合には、それぞれ状況に応じたメッセージが表示されるようになっています。

この機能は、システムエンジニアがウェブサイトのIPアドレスを確認したり、ドメインが正しく設定されているかといった基本的な情報を調べる際に役立ちます。例えば、ウェブサイトが特定のサーバーを指しているかといった、ドメインの基礎的な設定状況を簡単に把握できるため、トラブルシューティングや設定確認の効率化に貢献します。