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

Copy
1<?php
2
3/**
4 * 指定されたホスト名に対してNAPTR DNSレコードを検索します。
5 *
6 * DNS_NAPTRは、dns_get_record()関数で使用される定数で、
7 * ENUM (Telephone Number Mapping) や SIP (Session Initiation Protocol) など、
8 * 動的なサービスディスカバリに使用されるNaming Authority Pointerレコードを
9 * 検索することを示します。
10 *
11 * @param string $hostname 検索するホスト名
12 * @return array 見つかったNAPTRレコードの配列、または空の配列
13 */
14function getNaptrRecords(string $hostname): array
15{
16    echo "Searching NAPTR records for: " . $hostname . PHP_EOL;
17
18    // DNS_NAPTR定数を使用して、NAPTRレコードタイプを指定してDNSルックアップを実行します。
19    // dns_get_record() は、指定されたホスト名とレコードタイプのDNSレコードを返します。
20    // レコードが見つからない場合や、DNSサーバーへの問い合わせに失敗した場合は false が返されることがあります。
21    $records = dns_get_record($hostname, DNS_NAPTR);
22
23    if (false === $records) {
24        // DNSサーバーへの問い合わせ自体に失敗した場合にエラーメッセージを出力
25        echo "Error: Could not retrieve DNS records for " . $hostname . ". Check hostname or DNS configuration." . PHP_EOL;
26        return [];
27    }
28
29    if (empty($records)) {
30        echo "No NAPTR records found for " . $hostname . PHP_EOL;
31        return [];
32    }
33
34    echo "Found " . count($records) . " NAPTR record(s):" . PHP_EOL;
35    foreach ($records as $record) {
36        // 各NAPTRレコードの詳細情報を出力
37        echo "  Host: " . ($record['host'] ?? 'N/A') . PHP_EOL;
38        echo "  Class: " . ($record['class'] ?? 'N/A') . PHP_EOL; // 通常は 'IN' (インターネット)
39        echo "  TTL: " . ($record['ttl'] ?? 'N/A') . PHP_EOL;
40        echo "  Type: " . ($record['type'] ?? 'N/A') . PHP_EOL; // ここでは 'NAPTR' となる
41        echo "  Order: " . ($record['order'] ?? 'N/A') . PHP_EOL; // 処理順序
42        echo "  Preference: " . ($record['pref'] ?? 'N/A') . PHP_EOL; // 同じOrder内での優先度
43        echo "  Flags: " . ($record['flags'] ?? 'N/A') . PHP_EOL; // レコードの動作を定義するフラグ
44        echo "  Service: " . ($record['service'] ?? 'N/A') . PHP_EOL; // サービスとプロトコル
45        echo "  Regexp: " . ($record['regexp'] ?? 'N/A') . PHP_EOL; // 正規表現置換ルール
46        echo "  Replacement: " . ($record['replacement'] ?? 'N/A') . PHP_EOL; // 次の問い合わせ先ドメイン名
47        echo "--------------------" . PHP_EOL;
48    }
49
50    return $records;
51}
52
53// サンプルとして、NAPTRレコードの検索を試みます。
54// 'example.com'のような一般的なドメインにはNAPTRレコードが存在しない可能性が高いです。
55// NAPTRレコードは、主にSIP (Session Initiation Protocol) などの
56// 特定のサービスディスカバリに使用されるため、VoIPプロバイダーのドメインや
57// 特定のENUMサービスに関連するドメインでよく見られます。
58// 動作確認のためには、NAPTRレコードが設定されている実際のドメインを試すことをお勧めします。
59// 例: '_sip._tcp.sip.example.com' (これは架空の例です)
60$domainToLookup = "example.com";
61getNaptrRecords($domainToLookup);
62
63// よりNAPTRレコードが存在する可能性のあるドメインの例 (コメントアウトしています)
64// これを試す場合は、上記の $domainToLookup をコメントアウトし、
65// 以下の行のコメントを解除してください。
66// $domainToLookupReal = "sip.linphone.org"; // 実際のSIPプロバイダー
67// getNaptrRecords($domainToLookupReal);
68
69?>

PHP 8のDNS_NAPTRは、DNSの名前解決において「NAPTR (Naming Authority Pointer) レコード」という特定の種類のレコードを検索するための定数です。この定数はPHPのDNS拡張機能の一部として提供され、主にインターネット電話サービス（SIP）や電話番号マッピング（ENUM）など、動的なサービスディスカバリに使われる情報をDNSから取得する際に利用されます。

サンプルコードでは、dns_get_record()関数にDNS_NAPTR定数を指定することで、特定のホスト名に対するNAPTRレコードを効率的に検索する方法を示しています。dns_get_record()関数は、引数で受け取ったホスト名とレコードタイプに基づいてDNS情報を問い合わせ、見つかったレコードを配列で返します。レコードが存在しない場合や問い合わせに失敗した場合はfalseを返すことがあります。

getNaptrRecords関数は、検索対象のホスト名を文字列として受け取ります。そして、見つかったNAPTRレコードの詳細情報を含む配列を戻り値として返します。レコードが見つからない場合やエラー発生時は空の配列が返されます。この定数と関数により、アプリケーションは特定のサービス提供に必要なルーティング情報などをDNSから動的に取得し、柔軟なシステム連携を実現できます。

Copy
1<?php
2
3/**
4 * 指定されたドメインのNAPTR (Name Authority Pointer) レコードを取得して表示します。
5 *
6 * DNS_NAPTR は、PHPの dns_get_record 関数でNAPTRレコードタイプを指定するために使用される定数です。
7 * NAPTRレコードは、主にENUM (E.164 NUmber Mapping) やSIP (Session Initiation Protocol) などの
8 * サービスディスカバリやマッピング情報を提供する際に利用されます。
9 *
10 * @param string $domain レコードを検索するドメイン名。
11 * @return void
12 */
13function getNaptrRecords(string $domain): void
14{
15    echo "--- ドメイン: '{$domain}' のNAPTRレコード検索 ---\n";
16
17    // dns_get_record 関数を使用して、指定されたドメインのNAPTRレコードを取得します。
18    // 第二引数に DNS_NAPTR 定数を指定することで、NAPTRタイプのみをフィルタリングします。
19    $naptrRecords = dns_get_record($domain, DNS_NAPTR);
20
21    if (!empty($naptrRecords)) {
22        echo "NAPTRレコードが見つかりました:\n";
23        foreach ($naptrRecords as $record) {
24            echo "  Host: " . ($record['host'] ?? 'N/A') . "\n";
25            // 'type' は定数の数値なので、NAPTRと補足することで分かりやすくします。
26            echo "  Type: " . ($record['type'] ?? 'N/A') . " (NAPTR)\n";
27            echo "  TTL: " . ($record['ttl'] ?? 'N/A') . "\n";
28            echo "  Order: " . ($record['order'] ?? 'N/A') . "\n";
29            echo "  Preference: " . ($record['pref'] ?? 'N/A') . "\n";
30            echo "  Flags: " . ($record['flags'] ?? 'N/A') . "\n";
31            echo "  Service: " . ($record['service'] ?? 'N/A') . "\n";
32            echo "  Regexp: " . ($record['regexp'] ?? 'N/A') . "\n";
33            echo "  Replacement: " . ($record['replacement'] ?? 'N/A') . "\n";
34            echo "----------------------------------------\n";
35        }
36    } else {
37        echo "指定されたドメイン '{$domain}' のNAPTRレコードは見つかりませんでした。\n";
38        echo "NAPTRレコードは、すべてのドメインに存在するわけではありません。\n";
39    }
40    echo "\n";
41}
42
43// サンプル使用例:
44// 1. NAPTRレコードが存在する可能性のあるドメイン (例: e164.arpa はENUMサービスでNAPTRレコードを使用します)
45getNaptrRecords('e164.arpa');
46
47// 2. NAPTRレコードが存在しない可能性が高い一般的なドメイン (例: example.com)
48getNaptrRecords('example.com');
49
50?>

このサンプルコードは、PHPのdns_get_record関数と定数DNS_NAPTRを使用して、指定されたドメインのNAPTR (Name Authority Pointer) レコードを取得し、その内容を表示する方法を示しています。DNS_NAPTRは、PHPのdns_get_record関数に渡すことで、NAPTRタイプのDNSレコードのみを検索するよう指示するための特別な定数です。NAPTRレコードは、主にENUM (E.164 Number Mapping) やSIP (Session Initiation Protocol) などのサービスにおいて、ドメイン名から利用可能なサービスを特定するマッピング情報を提供するために利用されます。

getNaptrRecords関数は、レコードを検索するドメイン名を文字列として引数に受け取ります。この関数はvoid型、つまり戻り値を持ちませんが、dns_get_record関数によって取得されたNAPTRレコードの情報を画面に出力します。dns_get_record関数は、第一引数にドメイン名、第二引数にDNS_NAPTR定数を指定することで、該当するNAPTRレコードの情報を連想配列の配列として返します。もしレコードが見つからなければ、空の配列が返されます。

サンプルコードでは、レコードが見つかった場合、そのホスト、タイプ、TTL、オーダー、プリファレンス、フラグ、サービス、正規表現、代替名といった詳細情報を整形して表示します。すべてのドメインにNAPTRレコードが存在するわけではないため、NAPTRレコードを持つ可能性のあるe164.arpaと、持たない可能性が高いexample.comの二つの例を試して結果を確認できます。