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

Copy
1<?php
2
3/**
4 * 指定されたドメインのCNAME (Canonical Name) レコードを解決し、その情報を表示します。
5 * DNS_CNAME定数を使用して、CNAMEレコードのみを取得します。
6 *
7 * @param string $domain 解決したいドメイン名（例: "www.example.com"）
8 * @return void
9 */
10function resolveDnsCname(string $domain): void
11{
12    echo "--- CNAMEレコードの解決 --- \n";
13    echo "対象ドメイン: {$domain}\n";
14
15    // dns_get_record関数を使用して、指定されたドメインのDNSレコードを取得します。
16    // 第2引数にDNS_CNAME定数を指定することで、CNAMEレコードのみをフィルタリングして取得します。
17    $records = dns_get_record($domain, DNS_CNAME);
18
19    // DNS名前解決に失敗した場合 (例: ドメインが存在しない、DNSサーバーにアクセスできない)
20    if ($records === false) {
21        echo "エラー: ドメイン {$domain} のDNSレコードを取得できませんでした。\n";
22        echo "  - ドメイン名が正しいか、ネットワーク接続を確認してください。\n";
23        return;
24    }
25
26    // CNAMEレコードが見つからなかった場合
27    if (empty($records)) {
28        echo "CNA MEレコードは {$domain} に見つかりませんでした。\n";
29        return;
30    }
31
32    echo "見つかったCNAMEレコード:\n";
33    foreach ($records as $record) {
34        // CNAMEレコードは通常 'target' キーを持ち、それが指し示す正規のホスト名を示します。
35        // 'host' は問い合わせたドメイン、'type' はレコードの種類（この場合はCNAME）です。
36        echo "  - ホスト名: {$record['host']}\n";
37        echo "    タイプ: {$record['type']}\n";
38        echo "    正規名 (ターゲット): {$record['target']}\n";
39        echo "    TTL (秒): {$record['ttl']}\n"; // Time To Live (キャッシュ保持期間)
40    }
41    echo "---------------------------\n\n";
42}
43
44// --- 使用例 ---
45
46// 1. CNAMEレコードを持つ可能性が高いドメインの例
47//    (多くの場合、"www.example.com"は"example.com"へのCNAMEです)
48resolveDnsCname("www.example.com");
49
50// 2. ルートドメイン（通常はCNAMEレコードを持たない）の例
51resolveDnsCname("example.com");
52
53// 3. 実際にCNAMEレコードが設定されていることの多いサービスの例
54//    (ただし、外部サービスへの依存のため、結果は実行環境により変動する可能性があります)
55//    resolveDnsCname("docs.google.com"); // 例として
56//    resolveDnsCname("blog.cloudflare.com"); // 例として
57
58// 4. 存在しないドメインの例（エラーハンドリングの確認）
59resolveDnsCname("non-existent-domain-test-12345.com");
60
61?>

このPHPサンプルコードは、DNS_CNAME定数を用いて、指定されたドメインのCNAME (Canonical Name) レコードを解決し、その詳細情報を表示する方法を示しています。CNAMEレコードは、あるドメイン名が別のドメイン名の別名であることを示すDNSエントリであり、WebサイトのリダイレクトやCDN設定などでよく利用されます。コードの中心となるresolveDnsCname関数は、解決したいドメイン名を文字列型の引数$domainとして受け取ります。この関数は具体的な処理結果を返さず（戻り値はvoid）、結果を直接画面に出力します。内部では、dns_get_record関数が呼び出され、第2引数にDNS_CNAME定数を指定することで、数あるDNSレコードの中からCNAMEタイプのみを効率的に取得します。取得されたレコードからは、問い合わせたホスト名、レコードタイプ、指し示す正規のホスト名（ターゲット）、キャッシュ保持期間（TTL）などの情報が抽出され、整形して表示されます。ドメインの存在確認やCNAMEレコードの有無に応じたエラーメッセージも含まれており、初心者でもDNSの名前解決の仕組みとPHPでの具体的な実装方法を学ぶことができます。

Copy
1<?php
2
3/**
4 * 指定されたホスト名のCNAME (Canonical Name) DNSレコードを取得します。
5 * この関数は、`dns_get_record` 関数と `DNS_CNAME` 定数の使用方法を示します。
6 * `DNS_CNAME` は、取得するレコードの種類をCNAMEに限定するために使用される定数です。
7 *
8 * @param string $hostname 検索対象のホスト名（例: 'www.example.com'）
9 * @return array|false 取得されたCNAMEレコードの配列、またはDNSクエリが失敗した場合は false
10 */
11function getCnameRecordsForHost(string $hostname): array|false
12{
13    // dns_get_record() 関数は、指定されたホスト名のDNSレコードを取得します。
14    // 第二引数に DNS_CNAME 定数を渡すことで、CNAMEレコードのみをフィルタリングして取得します。
15    // DNS_CNAME はPHPの組み込み定数で、CNAMEレコードタイプを表すビットマスクです。
16    $records = dns_get_record($hostname, DNS_CNAME);
17
18    return $records;
19}
20
21// --- サンプルコードの実行部分 ---
22
23// CNAMEレコードを持つ可能性のあるホスト名を指定します。
24// 例: 'www.cloudflare.com' は、CDNプロバイダーのCNAMEレコードを指すことがよくあります。
25$targetHost = 'www.cloudflare.com';
26
27echo "ホスト名 '{$targetHost}' のCNAMEレコードを取得します...\n\n";
28
29$cnameRecords = getCnameRecordsForHost($targetHost);
30
31if ($cnameRecords !== false) {
32    if (!empty($cnameRecords)) {
33        echo "--- 取得されたCNAMEレコード ---\n";
34        foreach ($cnameRecords as $record) {
35            echo "  ホスト: {$record['host']}\n";
36            echo "  タイプ: {$record['type']}\n"; // これは常に 'CNAME' となります
37            echo "  ターゲット: {$record['target']}\n"; // このCNAMEレコードが指す実際のホスト名
38            echo "  TTL: {$record['ttl']}秒\n"; // レコードがキャッシュされる時間
39            echo "  --------------------\n";
40        }
41    } else {
42        echo "ホスト名 '{$targetHost}' にはCNAMEレコードが見つかりませんでした。\n";
43        echo "または、DNSクエリは成功しましたが、該当するレコードがありませんでした。\n";
44    }
45} else {
46    echo "DNSレコードの取得中にエラーが発生しました。ホスト名を確認してください。\n";
47}

このPHPサンプルコードは、特定のホスト名に対するCNAME（Canonical Name）DNSレコードを取得する方法を、システムエンジニアを目指す初心者の方にも分かりやすく示しています。PHP 8で利用可能なdns_get_record関数と、CNAMEレコードタイプを指定するための組み込み定数DNS_CNAMEを使用しています。

getCnameRecordsForHost関数は、検索対象となるホスト名を文字列として引数$hostnameに受け取ります。この関数内部でdns_get_record関数を呼び出し、第二引数にDNS_CNAME定数を渡すことで、取得するレコードの種類をCNAMEレコードのみに限定しています。DNS_CNAMEは、PHPが提供する定数であり、CNAMEレコードタイプを表すビットマスクです。関数は、見つかったCNAMEレコードの情報を連想配列の形式で格納した配列、またはDNSクエリが失敗した場合にはブール値falseを返します。

サンプルコードの実行部分では、www.cloudflare.comというホスト名を例に、getCnameRecordsForHost関数を呼び出してCNAMEレコードを取得しています。取得されたレコードは配列として処理され、各レコードからホスト名、タイプ、ターゲット、TTL（Time-To-Live）などの具体的な情報が抽出され、コンソールに表示されます。レコードが見つからなかった場合や、DNSクエリ自体がエラーとなった場合にも、それぞれに応じたメッセージが表示されるため、コードの動作を明確に確認できます。