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

Copy
1<?php
2
3/**
4 * 指定されたIPアドレスのPTRレコード（ポインターレコード、逆引き情報）を取得し、表示します。
5 *
6 * PTRレコードは、IPアドレスからドメイン名を特定する逆引きDNSの仕組みで使用されます。
7 *
8 * @param string $ipAddress 逆引きしたいIPアドレス。
9 * @return void
10 */
11function displayPtrRecords(string $ipAddress): void
12{
13    echo "--- IPアドレス '{$ipAddress}' のPTRレコードを検索中 ---\n";
14
15    // dns_get_record関数を使用してDNSレコードを取得します。
16    // 第二引数にDNS_PTR定数を指定することで、ポインターレコードのみを検索します。
17    // DNS_PTRは、PHPのDNS拡張機能によって提供される定数で、PTRレコードタイプを表す整数値です。
18    $records = dns_get_record($ipAddress, DNS_PTR);
19
20    if (empty($records)) {
21        echo "  - PTRレコードは見つかりませんでした。\n";
22        return;
23    }
24
25    echo "  見つかったPTRレコード:\n";
26    foreach ($records as $record) {
27        // PTRレコードの 'target' キーには、逆引きされたドメイン名が含まれます。
28        echo "    - ホスト名: {$record['host']}\n";
29        echo "      タイプ: {$record['type']} (PTR)\n";
30        echo "      TTL (秒): {$record['ttl']}\n";
31        echo "      ターゲット (逆引きドメイン): {$record['target']}\n";
32    }
33}
34
35// 例1: GoogleのパブリックDNSサーバーのIPアドレス
36displayPtrRecords('8.8.8.8');
37
38echo "\n";
39
40// 例2: CloudflareのパブリックDNSサーバーのIPアドレス
41displayPtrRecords('1.1.1.1');
42
43echo "\n";
44
45// 例3: プライベートIPアドレス（通常、公開DNSにはPTRレコードが存在しません）
46displayPtrRecords('192.168.1.1');

PHPのDNS拡張機能は、指定されたIPアドレスに対応するPTRレコード（ポインターレコード、逆引き情報）を取得し、画面に表示するサンプルコードです。PTRレコードとは、IPアドレスから対応するドメイン名を特定する「逆引きDNS」の仕組みで用いられる特殊なDNSレコードです。

このコードの中心となるdisplayPtrRecords関数は、文字列型でIPアドレスを引数として受け取ります。関数内部では、PHPの標準関数であるdns_get_recordを使用してDNSレコードの検索を行います。ここで重要なのが、dns_get_recordの第二引数にDNS_PTR定数を渡している点です。DNS_PTRはPHPのDNS拡張機能によって提供される定数であり、PTRレコードタイプを表す整数値です。これにより、他のDNSレコードタイプを無視し、PTRレコードのみを効率的に検索できます。

dns_get_record関数は、指定されたIPアドレスとレコードタイプに基づいてDNS情報を検索し、見つかったレコードの詳細を連想配列のリストとして返します。もしレコードが見つからなかった場合、この関数は空の配列を返します。

displayPtrRecords関数は、dns_get_recordの結果が空でないことを確認し、PTRレコードが見つかった場合は、各レコードのホスト名、タイプ、有効期間（TTL）、そして逆引きされたドメイン名が格納されている「ターゲット」の情報を整形して画面に出力します。レコードが見つからなかった場合は、その旨を通知するメッセージを表示します。この関数自体は、画面出力のみを行うため、戻り値は特にありません。

Copy
1<?php
2
3/**
4 * 指定されたIPv4アドレスのPTRレコード（逆引きDNSレコード）を取得します。
5 * DNS_PTR定数を使用して、特定のレコードタイプのみを要求します。
6 *
7 * @param string $ipAddress 逆引きしたいIPv4アドレス。例: '8.8.8.8'
8 * @return array|false PTRレコードの配列、または失敗した場合はfalse。
9 */
10function getPtrRecords(string $ipAddress): array|false
11{
12    // IPアドレスが有効なIPv4形式か確認します。
13    if (!filter_var($ipAddress, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
14        echo "エラー: 無効なIPv4アドレスが指定されました。\n";
15        return false;
16    }
17
18    // IPv4アドレスを逆引きドメイン名形式 (例: "1.2.0.192.in-addr.arpa") に変換します。
19    // PTRレコードを検索するためには、IPアドレスを逆順にして ".in-addr.arpa" を付加する必要があります。
20    $parts = explode('.', $ipAddress);
21    // filter_varでIPv4を検証しているので、通常は4つのパートになりますが、念のためチェック
22    if (count($parts) !== 4) {
23        echo "エラー: IPv4アドレスの形式が不正です。\n";
24        return false;
25    }
26    $reverseDomain = implode('.', array_reverse($parts)) . '.in-addr.arpa';
27
28    // dns_get_record関数を使用してPTRレコードを取得します。
29    // ここでDNS_PTR定数を使用し、要求するレコードタイプがPTRであることを明示します。
30    $records = dns_get_record($reverseDomain, DNS_PTR);
31
32    return $records;
33}
34
35// --- サンプル使用例 ---
36
37// Google Public DNSのIPアドレスを逆引きしてみます。
38$targetIp = '8.8.8.8';
39echo "IPアドレス {$targetIp} のPTRレコードを取得します...\n";
40$ptrRecords = getPtrRecords($targetIp);
41
42if ($ptrRecords === false) {
43    echo "PTRレコードの取得に失敗しました。\n";
44} elseif (empty($ptrRecords)) {
45    echo "IPアドレス {$targetIp} に関連するPTRレコードは見つかりませんでした。\n";
46} else {
47    echo "--- 取得されたPTRレコード ---\n";
48    foreach ($ptrRecords as $record) {
49        // PTRレコードの 'target' キーには、対応するホスト名が含まれます。
50        echo "ホスト名: " . ($record['target'] ?? '不明') . "\n";
51        echo "タイプ: " . ($record['type'] ?? '不明') . " (DNS_PTRで指定)\n";
52        echo "TTL: " . ($record['ttl'] ?? '不明') . "秒\n";
53        echo "---------------------------\n";
54    }
55}
56
57// 別の例：PTRレコードがない可能性のあるIPアドレス
58$targetIp2 = '192.0.2.1'; // 予約されたテスト用IPアドレス (TEST-NET-1)
59echo "\nIPアドレス {$targetIp2} のPTRレコードを取得します...\n";
60$ptrRecords2 = getPtrRecords($targetIp2);
61
62if ($ptrRecords2 === false) {
63    echo "PTRレコードの取得に失敗しました。\n";
64} elseif (empty($ptrRecords2)) {
65    echo "IPアドレス {$targetIp2} に関連するPTRレコードは見つかりませんでした。\n";
66} else {
67    echo "--- 取得されたPTRレコード ---\n";
68    foreach ($ptrRecords2 as $record) {
69        echo "ホスト名: " . ($record['target'] ?? '不明') . "\n";
70        echo "タイプ: " . ($record['type'] ?? '不明') . " (DNS_PTRで指定)\n";
71        echo "TTL: " . ($record['ttl'] ?? '不明') . "秒\n";
72        echo "---------------------------\n";
73    }
74}

PHP 8のDNS_PTR定数は、DNSの名前解決において、特定のレコードタイプである「PTRレコード」（ポインターレコード）を指定するために使用される整数値の定数です。主にdns_get_record()関数と組み合わせて使われ、IPアドレスから対応するドメイン名（ホスト名）を検索する「逆引きDNS」を実行する際に利用されます。

提示されたサンプルコードのgetPtrRecords関数は、与えられたIPv4アドレスのPTRレコードを取得する処理をカプセル化しています。この関数の引数$ipAddressには、逆引きしたいIPv4アドレス（例: '8.8.8.8'）を文字列として渡します。関数内では、まずIPアドレスが有効か検証し、逆引きのための特殊なドメイン名形式（例: '8.8.8.8.in-addr.arpa'）に変換します。その後、dns_get_record()関数を呼び出す際に、第2引数にDNS_PTR定数を指定することで、取得するDNSレコードの種類をPTRレコードのみに限定しています。

getPtrRecords関数の戻り値は、取得に成功した場合はPTRレコードの詳細情報を含む連想配列の配列、失敗した場合はfalseです。成功時の配列には、targetキーで逆引きによって得られたホスト名が含まれており、IPアドレスがどのドメイン名に紐付いているかを確認できます。このようにDNS_PTR定数を活用することで、PHPでIPアドレスからのホスト名解決（逆引きDNS）を正確かつ簡潔に行うことができます。