>PHP: dns_get_record

DescripciÃ³n

array dns_get_record ( string nombre_host [, int tipo [, array &authns, array &addtl]] )

Nota: Esta funciÃ³n no estÃ¡ implementada en plataformas Windows, ni funciona (actualmente) en systemas *BSD. Pruebe con la clase PEAR Net_DNS.

Esta funciÃ³n devuelve una matriz de matrices asociativas. Cada matriz asociativa contiene por lo menos las siguientes claves:

Tabla 1. Atributos DNS bÃ¡sicos

Atributo	Significado
host	El registro en el espacio de nombres DNS al que hacen referencia el resto de datos asociados.
class	dns_get_record() devuelve Ãºnicamente registros de clase Internet y como tal, Ã©ste parÃ¡metro siempre devolverÃ¡ `IN`.
type	Cadena que contiene el tipo de registro. Otros atributos adicionales serÃ¡n contenidos tambiÃ©n en la matriz resultante dependiendo del valor de type. Vea la tabla mÃ¡s adelante.
ttl	Valor Time To Live restante para este registro. Este no serÃ¡ igual al ttl original del registro, sino que serÃ¡ igual al ttl original menos cualquiera que haya sido la longitud de tiempo transcurrido desde que el servidor de nombres oficial fuera consultado.

nombre_host debe ser un nombre de servidor huÃ©sped DNS vÃ¡lido, como "www.example.com". Pueden generarse consultas revertidas usando la notaciÃ³n in-addr.arpa, pero gethostbyaddr() es mÃ¡s apropiada para la mayorÃa de consultas revertidas.

Por defecto, dns_get_record() buscarÃ¡ por cualquier registro de recurso asociado con nombre_host. Para limitar la consulta, especifique el parÃ¡metro opcional tipo. tipo puede ser cualquiera de los siguientes: 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 o DNS_ANY. El valor predeterminado es DNS_ANY.

Nota: Debido a excentricidades en el rendimiento de libresolv entre plataformas, DNS_ANY no siempre devolverÃ¡ todos los registros, la alternativa mÃ¡s lenta DNS_ALL recolectarÃ¡ todos los registros de forma mÃ¡s confiable.

Los opcionales tercer y cuarto argumento de esta funciÃ³n, authns y addtl son pasados por referencia y, si son usados, serÃ¡n llenados con Registros de Recurso para los Servidores de Nombres Oficiales, y cualquier Registro Adicional respectivamente. Vea el ejemplo mÃ¡s adelante.

Tabla 2. Otras claves en las matrices asociativas, dependientes de 'type'

Tipo	Columnas Extra
`A`	`ip`: Una direcciÃ³n IPv4 en notaciÃ³n decimal con puntos.
`MX`	`pri`: Prioridad del gestor de correo. NÃºmeros bÃ¡s bajos indican mayor prioridad. `target`: FQDN del gestor de correo. Vea tambiÃ©n dns_get_mx().
`CNAME`	`target`: FQDN de la ubicaciÃ³n en el espacio de nombres DNS de la cual es alias el registro.
`NS`	`target`: FQDN del servidor de nombres que es la autoridad para este nombre de host.
`PTR`	`target`: UbicaciÃ³n dentro del espacio de nombres DNS a la que apunta este registro.
`TXT`	`txt`: Cadena de datos arbitraria asociada con este registro.
`HINFO`	`cpu`: NÃºmero IANA que indica el CPU de la mÃ¡quina referenciada por este registro. `os`: NÃºmero IANA que indica el Sistema Operativo en la mÃ¡quina referenciada por este registro. Vea los Nombres de Sistemas Operativos de IANA para consultar el significado de estos valores.
`SOA`	`mname`: FQDN de la mÃ¡quina desde donde se originaron los registros de recurso. `rname`: DirecciÃ³n de correo electrÃ³nico del contacto administrativo para este dominio. `serial`: # serial de esta revisiÃ³n del dominio solicitado. `refresh`: Intervalo de actualizaciÃ³n (segundos) que deben usar los servidores de nombre secundarios cuando actualicen las copias remotas de este dominio. `retry`: Periodo de tiempo (segundos) para esperar despuÃ©s de una actualizaciÃ³n fallida antes de hacer un segundo intento. `expire`: Periodo mÃ¡ximo de tiempo (segundos) que un servidor DNS secundario debe conservar copias remotas de los datos de zona sin una actualizaciÃ³n exitosa antes de descartarlos. `minimum-ttl`: Periodo mÃnimo de tiempo (segundos) en el que un cliente puede continuar usando una resoluciÃ³n DNS antes de que deba solicitar una nueva resoluciÃ³n del servidor. Puede ser sobrescrito por registros de recurso individuales.
`AAAA`	`ipv6`: DirecciÃ³n IPv6
`A6`(PHP >= 5.1.0)	`masklen`: Longitud (en bits) para heredar del destino especificado por `chain`. `ipv6`: DirecciÃ³n para mezclar este registro especÃfico con `chain`. `chain`: Registro padre a mezclar con los datos de `ipv6`.
`SRV`	`pri`: (Prioridad) las prioridades mÃ¡s bajas deben ser usadas primero. `weight`: Rangos para pesar cuÃ¡l de los `destinos` comunmente con prioridades debe ser elegido al azar. `target` y `port`: nombre de servidor huÃ©sped y puerto en dondo puede encontrarse el servicio solicitado. Para mÃ¡s informaciÃ³n, vea: RFC 2782
`NAPTR`	`order` y `pref`: Equivalente a `pri` y `weight` descritos anteriormente. `flags`, `services`, `regex`, y `replacement`: ParÃ¡metros, como se definen por RFC 2915.

Nota: Debido a estÃ¡ndares DNS, las direcciones de correo electrÃ³nico son dadas en formato usuario.host (por ejemplo: hostmaster.example.com en lugar de hostmaster@example.com), asegÃºrese de chequear este valor y modificarlo si es necesario antes de usarlo con funciones como mail().

Ejemplo 1. Uso de dns_get_record()


<?php

$resultado = dns_get_record("php.net");

print_r($resultado);

?>

Produce una salida similar a la siguiente:

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
        )

)

Ya que es muy comÃºn desear la direcciÃ³n IP de un servidor de correo una vez el registro MX ha sido resuelto, dns_get_record() tambiÃ©n devuelve una matriz en addtl la cual contiene registros asociados. authns es devuelto tambiÃ©n, conteniendo una lista de servidores de nombre oficiales.

Ejemplo 2. Uso de dns_get_record() y DNS_ANY


<?php



/* Solicitar "cualquier" registro para php.net, y crear las matrices

   $authns y $addtl conteniendo una lista de servidores de nombre y

   cualquier registro adicional que vaya con ellos */



$resultado = dns_get_record("php.net", DNS_ANY, $authns, $addtl);

echo "Resultado = ";

print_r($resultado);

echo "Auth NS = ";

print_r($authns);

echo "Adicional = ";

print_r($addtl);

?>

Produce una salida similar a la siguiente:

MANUAL DE PHP

windsurf mercedes camper

dns_get_record

DescripciÃ³n