PHP Australia Conference 2015

dns_get_record

(PHP 5)

dns_get_recordBelirtilen konak adı ile ilgili DNS Özkaynak Kayıtlarını getirir

Açıklama

array dns_get_record ( string $konakadı [, int $tür = DNS_ANY [, array &$yetkili_enesler [, array &$ek_kayıtlar ]]] )

Belirtilen konakadı ile ilgili DNS Özkaynak Kayıtlarını (DNS-RR) getirir.

Değiştirgeler

konakadı

konakadı, "www.example.com" gibi geçerli bir konak adı olmalıdır. Ters DNS sorguları in-addr.arpa gösterimiyle üretilir, fakat gethostbyaddr() işlevi ters DNS sorguları için daha kullanışlıdır.

Bilginize:

DNS standartlarının amacı gereği, posta adresleri kullanıcı.konak biçiminde verilir (örneğin, hostmaster@example.com değil hostmaster.example.com). Sorgudan böyle bir değer aldıysanız, mail() gibi bir işlevde kullanmadan önce bunu normal eposta adresi haline getirmelisiniz.

tür

dns_get_record() öntanımlı olarak, konakadı ile ilgili bütün özkaynak kayıtlarını arayacaktır. Sorguyu belli kayıtlarla sınırlamak için isteğe bağlı tür değiştirgesini kullanabilirsiniz. tür olarak şunlardan biri belirtilebilir: DNS_A, DNS_CNAME, DNS_HINFO, DNS_MX, DNS_NS, DNS_PTR, DNS_SOA, DNS_TXT, DNS_AAAA, DNS_SRV, DNS_NAPTR, DNS_A6, DNS_ALL veya DNS_ANY. DNS_ANY öntanımlıdır.

Bilginize:

Çeşitli platformlarda libresolv başarımının dışmerkezliliğinden dolayı DNS_ANY her zaman bütün kayıtları döndürmez. Daha yavaş fakat daha güvenilir olan DNS_ALL tüm kayıtları toplayacaktır.

yetkili_enesler

Gönderimli aktarılır. Belirtilirse Yetkili Ad Sunucuları ile ilgili Özkaynak Kayıtları bu diziye yerleştirilir.

ek_kayıtlar

Gönderimli aktarılır. Belirtilirse Ek Kayıtlar ile ilgili Özkaynak Kayıtları bu diziye yerleştirilir.

Dönen Değerler

Bu işlev ilişkisel diziler içeren bir dizi ile döner. He ilişkisel dizi en azından aşağıdaki anahtarları mutlaka içerir:

Temel DNS öznitelikleri
Öznitelik Anlamı
host DNS isim alanındaki, ilişkili tüm verinin atfedildiği kayıt.
class dns_get_record() daima sadece İnternet sınıfı kayıtları döndürdüğünden bu üyenin değeri daima IN'dir.
type Kayıt türünü içeren dizge. Tür değerine bağlı olarak dizide ek öznitelikler bulunabilir. Aşağıdaki tabloya bakınız.
ttl "Time To Live". Bu kayıt için kalan yaşam süresi. Bu değer, özgün ttl ile aynı değildir. Özgün ttl'den yetkili isim sunucu sorgulandığından beri geçen süre düşüldükten sonra kalan değerdir.

İlişkisel dizide 'type' anahtarına bağlı diğer anahtarlar
Tür Ek Sütunlar
A ip: Noktalı sayısal gösterimle bir IPv4 adresi.
MX pri: Posta alıcısının önceliği. Düşük sayılar daha yüksek öncelik belirtir.
target: Posta alıcısının tamamen nitelenmiş alan adı. Ayrıca bakınız: dns_get_mx().
CNAME target: Kaydın takma ad olduğu DNS isim alanındaki konumun tamamen nitelenmiş alan adı.
NS target: Bu konak adı için yetkili olan isim sunucusunun tamamen nitelenmiş alan adı.
PTR target: DNS isim alanında bu kayda işaret eden konum.
TXT txt: Bu kayıtla ilişkili dizge türünde keyfi bir veri.
HINFO cpu: Bu kaydın gösterdiği makinenin işlemcisi için IANA ismi.
os: Bu kaydın gösterdiği makinenin işletim sistemi için IANA ismi. Bu değerlerin anlamları için IANA'nın » İşletim Sistemi İsimleri belgesine bakınız.
SOA mname: Özkaynak kaydının kaynaklandığı makinenin tamamen nitelenmiş alan adı.
rname: Bu alanın içerik yetkilisinin eposta adresi.
serial: İstenen alanın bu sürümünün sıra numarası.
refresh: Bu alanın uzak kopyaları güncellenirken ikincil isim sunucularının tazelenme süresi (saniye cinsinden).
retry: Tekrar bir tazeleme yapmadan önce beklenecek süre (saniye cinsinden).
expire: Başarısız bir tazelemenin ardından bölge verisinin uzak kopyalarını silmeden önce DNS sunucusunun bekleyeceği azami süre (saniye cinsinden).
minimum-ttl: Bir istemcinin sunucudan yeni bir çözünürlük isteği yapmadan önce mevcut DNS çözünürlüğünü kullanmaya devam edebileceği asgari süre (saniye cinsinden). Özkaynak kayıtlarının her biri kendi süresini belirleyerek bunu geçersiz kılabilir.
AAAA ipv6: IPv6 adresi.
A6 (PHP >= 5.1.0) masklen: chain ile belirtilen hedeften miras alınan uzunluk (bit cinsinden).
ipv6: chain'e katıştırılacak bu özel kayıt için adres.
chain: ipv6 verisi ile katıştırılacak ebeveyn kayıt.
SRV pri: (Priority kısaltması) En düşük değerin önceliği en yüksektir.
weight: Ortak önceliklerin tercih sıralaması.
targets rasgele seçilmelidir. target ve port: İstenen hizmetin bulunabileceği konak adı ve port. Ek bilgi için » RFC 2782'ye bakınız.
NAPTR order ve pref: Yukarıdaki pri ve weight ile eşdeğerdirler.
flags, services, regex ve replacement: » RFC 2915 tarafından tanımlanmış değiştirgelerdir.

Sürüm Bilgisi

Sürüm: Açıklama
5.3.0 İşlev Windows platformlarında da kullanılabilir oldu.

Örnekler

Örnek 1 - dns_get_record() kullanımı

<?php
$result 
dns_get_record("php.net");
print_r($result);
?>

Yukarıdaki örnek şuna benzer bir çıktı üretir:

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
        )

)

Örnek 2 - dns_get_record() ve DNS_ANY kullanımı

MX kaydı çözümlendikten sonra normal olarak posta sunucusunun adresi istenir. dns_get_record() işlevi ayrıca, ilişkili kayıtları ek_kayıtlar dizisinde döndürür. Bunun yanında, yetkili_enesler dizisinde de yetkili isim sunucularının listesini döndürür.

<?php
/* php.net için "ANY" kayıt isteği yaparken
   isim sunucularının ve ek kayıtların listeleri için
   $yetkiliNS ve $ekkayıtlar dizilerini kullanalım */
 
$yetkilins=array(); $ekler=array();
$sonuç dns_get_record("php.net"DNS_ANY$yetkilins$ekler);
echo 
"Sonuç = ";
print_r($sonuç);
echo 
"Yetkili NS = ";
print_r($yetkilins);
echo 
"Ek Kayıtlar = ";
print_r($ekler);
?>

Yukarıdaki örnek şuna benzer bir çıktı üretir:

Sonuç = 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
        )

)
Yetkili 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
        )

)
Ek Kayıtlar = 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
        )

)

Notlar

Bilginize:

Bu işlevin henüz gerçeklenmediği PHP sürümlerinin kullanıldığı Windows ve *BSD sistemlerinde de (Mac dahil) » PEAR » Net_DNS sınıfını deneyin.

Ayrıca Bakınız

add a note add a note

User Contributed Notes 3 notes

up
4
PHP Joe
1 year ago
Although this works very well for general DNS queries if you want to do a direct DNS query to a specified DNS server (rather than using OS resolution) try PHPDNS: http://www.purplepixie.org/phpdns/

You can do direct (TCP or UDP) low-level queries to a nameserver and recurse at will. Very useful for testing specific servers and also for walking through a recursive resolution.
up
1
dylan at pow7 dot com
5 years ago
Get more than one type at once like this:
<?php
$dnsr
= dns_get_record('php.net', DNS_A + DNS_NS);
print_r($dnsr);
?>

Using DNS_ALL fails on some domains where DNS_ANY works. I noticed the function getting stuck on the DNS_PTR record, which caused it to return FALSE with this error:
PHP Warning:  dns_get_record(): res_nsend() failed in ....

This gets all records except DNS_PTR:
<?php
$dnsr
= dns_get_record('php.net', DNS_ALL - DNS_PTR);
print_r($dnsr);
?>
up
-1
karl at influ dot io
1 year ago
There's a comment below from 7 years ago regarding BSD and MacOSX, I'd just like to follow up incase some people see that and don't think it'll work on MacOSX.

Software:

    System Software Overview:

      System Version: OS X 10.8.3 (12D78)
      Kernel Version: Darwin 12.3.0
      Boot Volume: Macintosh HD
      Boot Mode: Normal
      Computer Name: Karl’s iMac
      User Name: Karl Kloppenborg (karl)
      Secure Virtual Memory: Enabled
      Time since boot: 10 days 20:24
--------------

# php -a
php > print_r(dns_get_record('google.com', DNS_MX));

Array
(
    [0] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 10
            [target] => aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

    [1] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 30
            [target] => alt2.aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

    [2] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 50
            [target] => alt4.aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

    [3] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 40
            [target] => alt3.aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

    [4] => Array
        (
            [host] => google.com
            [type] => MX
            [pri] => 20
            [target] => alt1.aspmx.l.google.com
            [class] => IN
            [ttl] => 749
        )

)
To Top