dns_get_record
(PHP 5, PHP 7, PHP 8)
dns_get_record — Liefert die zu einem Hostnamen gehörenden DNS-Einträge
Beschreibung
string
$hostname,int
$type = DNS_ANY,array
&$authoritative_name_servers = null,array
&$additional_records = null,bool
$raw = false): array|false
Fragt die zum übergebenen hostname gehörenden DNS
Resource Records ab.
Parameter-Liste
-
hostname -
hostnamesollte ein gültiger Hostname wie z. B. "www.example.com" sein. Reverse Lookups sind mit derin-addr.arpa-Notation möglich, jedoch sollte für diesen Fall gethostbyaddr() genutzt werden.Hinweis:
Gemäß dem DNS-Standard werden E-Mail-Adressen in der Form
user.hostzurückgegeben (zum Beispiel:hostmaster.example.comstatthostmaster@example.com). Darum ist es wichtig, diesen Wert zu überprüfen und ihn ggf. zu ändern, bevor Sie ihn in Funktionen wie z. B mail() verwenden. -
type -
Standardmäßig sucht dns_get_record() nach jedem Resource Record für den
hostname. Um die Anfrage zu einzuschränken, musstypegegeben sein. Dieser Paramter kann einen der folgenden Werte annehmen:DNS_A,DNS_CAA,DNS_CNAME,DNS_HINFO,DNS_MX,DNS_NS,DNS_PTR,DNS_SOA,DNS_TXT,DNS_AAAA,DNS_SRV,DNS_NAPTR,DNS_A6,DNS_ALLoderDNS_ANY.Hinweis:
Durch Eigenheiten in der Performance von libresolv auf verschiedenen Plattformen kann es passieren, dass
DNS_ANYnicht alle Records zurückgibt. Das langsamereDNS_ALLarbeitet in diesem Fall zuverlässiger.Hinweis:
DNS_CAAwird unter Windows nicht unterstützt. Die Unterstützung fürDNS_A6ist nicht implementiert. -
authoritative_name_servers -
Wird per Referenz übergeben und wird, wenn es angegeben wurde, mit den Records für die Autoritativen Nameserver gefüllt.
-
additional_records -
Wird per Referenz übergeben und wird, wenn es angegeben wurde, mit allen zusätzlichen Records gefüllt.
-
raw -
Der Parameter
typewird als unverarbeitete DNS-Typ-ID interpretiert (dieDNS_*-Konstanten können nicht verwendet werden). Der Rückgabewert enthält einendata-Schlüssel, der manuell geparst werden muss.
Rückgabewerte
Diese Funktion gibt ein Array an assioziativen Arrays zurück.
Bei einem Fehler wird false zurückgegeben. Jedes assoziative Array enthält
mindestens die folgenden Keys:
| Attribut | Bedeutung |
|---|---|
| host | Der Host im DNS-Namensraum, auf den sich die restlichen Werte in dem assoziativen Array beziehen. |
| class |
dns_get_record() gibt nur Internet Class Records
zurück, wodurch dieser Paramater immer IN
zurückgibt.
|
| type | Ein String, in dem der Record-Typ hinterlegt ist. Zusätzliche Attribute sind, abhängig vom Typ, ebenfalls in dem Array enthalten. Siehe untere Tabelle. |
| ttl |
"Time To Live", die Zeit, die für diesen Record
noch verbleibt. Diese ist nicht identisch mit der
ursprünglichen ttl des Records, sondern entspricht der ursprünglichen
ttl abzüglich der Zeit, die seit der Abfrage des autoritativen
Namensservers vergangen ist.
|
| Type | Extra Spalten |
|---|---|
A |
ip: Eine IPv4-Addresse in dezimaler Punktnotation.
|
MX |
pri: Die Priorität des MX-Records. Niedrigere
Zahlen bedeuten eine höhere Priorität. target: FQDN
des MX-Records. Siehe auch: dns_get_mx().
|
CNAME |
target: Die FQDN des Ziels, auf das dieser Alias
zeigt.
|
NS |
target: Die FQDN des Nameservers, der der
autorative Nameserver für dieses Zone ist.
|
PTR |
target: Die Stelle im DNS-Namensraum, auf den
dieser Record zeigt.
|
TXT |
txt: Ein beliebiger String, der diesem Record
zugeordnet ist.
|
HINFO |
cpu: Die IANA-Nummer für die CPU des Hosts, der
durch diesen Record referenziert wird. os: Die
IANA-Nummer für das Betriebssystem des Hosts, der durch diesen Record
referenziert wird. Siehe IANAs
» Operating System Names
für die Bedeutung dieses Records.
|
CAA |
flags: Ein Ein-Byte-Bitfeld; zurzeit ist nur Bit 0
definiert, was "kritisch" bedeutet; andere Bits sind reserviert und
sollten ignoriert werden. tag: Der CAA-Tag-Name
(alphanumerische ASCII-Zeichenkette). value: Der
CAA-Tag-Wert (Binärstring, der Unterformate verwenden kann). Für
weitere Information siehe
» RFC 6844
|
SOA |
mname: Der FQDN für den Host, von dem diese
Resource Records kommen. rname: Die E-Mail-Adresse
des Administrators dieser Domain. serial: Die
aufsteigende Nummer für die Revision der angefragten Domain.
refresh: Das Aktualisierungsintervall, das die
sekundären Nameserver nutzen sollten, wenn sie ihre gespiegelten
Kopien der Zone aktualisieren wollen. retry: Die
Zeit, die nach einem fehlerhaften Versuch gewartet werden soll.
expire: Die maximale Zeit, die ein sekundärer
Nameserver Kopien der Zone behalten soll. Wird nach jedem
erfolgreichen Refresh neu gezählt. minimum-ttl: Die
Anzahl der Sekunden, die eine Anfrage im Cache behalten wird. Kann von
individuellen Resource Records überschrieben werden.
|
AAAA |
ipv6: Die IPv6-Addresse.
|
A6 |
masklen: Die Anzahl der Bits, die von dem durch
chain vorgegeben Ziel geerbt werden.
ipv6: Die Adresse für diesen speziellen Record, der
mit chain zusammengeführt werden soll.
chain: Der übergeordnete Record, der mit den
ipv6-Daten zusammengeführt werden soll.
|
SRV |
pri: (Priorität) Die niedrigsten Prioritäten
sollten zuerst verwendet werden. weight: Die
Rangfolge der Gewichtung, welche der üblicherweise priorisierten
targets zufällig ausgewählt werden sollen.
Bsp.: Ziel A: 3, Ziel B: 2. Ziel A wird im Mittel in 60% der Fälle
gewählt. target und port:
Hostname und Port, unter dem der Service erreicht werden kann. Für
weitere Information siehe:
» RFC 2782.
|
NAPTR |
order und pref: Gleichwertig zu
pri und weight oben.
flags, services,
regex, und replacement:
Parameter wie in » RFC 2915
definiert.
|
Changelog
| Version | Beschreibung |
|---|---|
| 7.0.16, 7.1.2 | Die Unterstützung für den CAA-Record-Typ wurde hinzugefügt. |
Beispiele
Beispiel #1 Benutzung von dns_get_record()
<?php
$result = dns_get_record("php.net");
print_r($result);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Array
(
[0] => Array
(
[host] => php.net
[type] => MX
[pri] => 5
[target] => pair2.php.net
[class] => IN
[ttl] => 6765
)
[1] => Array
(
[host] => php.net
[type] => A
[ip] => 64.246.30.37
[class] => IN
[ttl] => 8125
)
)
Beispiel #2 Benutzung von dns_get_record() und DNS_ANY
Da man häufig auch die IP des Mailservers für einen MX-Record benötigt,
gibt dns_get_record() auch ein Array in
additional_records zurück, in dem die zugehörigen
Records zu finden sind. Ebenso wird
authoritative_name_servers mit einer Liste der
autorativen Nameserver zurückgegeben.
<?php
/* Fordert alle ("ANY") Records für php.net an
und erstellt dann die Arrays $authns und $addtl,
die eine Liste von Servernamen enthalten, und alle
Aufzeichnungen, die zu ihnen gehören
*/
$result = dns_get_record("php.net", DNS_ANY, $authns, $addtl);
echo "Result = ";
print_r($result);
echo "Auth NS = ";
print_r($authns);
echo "Additional = ";
print_r($addtl);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Result = Array
(
[0] => Array
(
[host] => php.net
[type] => MX
[pri] => 5
[target] => pair2.php.net
[class] => IN
[ttl] => 6765
)
[1] => Array
(
[host] => php.net
[type] => A
[ip] => 64.246.30.37
[class] => IN
[ttl] => 8125
)
)
Auth NS = Array
(
[0] => Array
(
[host] => php.net
[type] => NS
[target] => remote1.easydns.com
[class] => IN
[ttl] => 10722
)
[1] => Array
(
[host] => php.net
[type] => NS
[target] => remote2.easydns.com
[class] => IN
[ttl] => 10722
)
[2] => Array
(
[host] => php.net
[type] => NS
[target] => ns1.easydns.com
[class] => IN
[ttl] => 10722
)
[3] => Array
(
[host] => php.net
[type] => NS
[target] => ns2.easydns.com
[class] => IN
[ttl] => 10722
)
)
Additional = Array
(
[0] => Array
(
[host] => pair2.php.net
[type] => A
[ip] => 216.92.131.5
[class] => IN
[ttl] => 6766
)
[1] => Array
(
[host] => remote1.easydns.com
[type] => A
[ip] => 64.39.29.212
[class] => IN
[ttl] => 100384
)
[2] => Array
(
[host] => remote2.easydns.com
[type] => A
[ip] => 212.100.224.80
[class] => IN
[ttl] => 81241
)
[3] => Array
(
[host] => ns1.easydns.com
[type] => A
[ip] => 216.220.40.243
[class] => IN
[ttl] => 81241
)
[4] => Array
(
[host] => ns2.easydns.com
[type] => A
[ip] => 216.220.40.244
[class] => IN
[ttl] => 81241
)
)
