<HTML
><HEAD
><TITLE
>dns_get_record</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="PHP Manual"
HREF="index.html"><LINK
REL="UP"
TITLE="Network Functions"
HREF="ref.network.html"><LINK
REL="PREVIOUS"
TITLE="dns_get_mx"
HREF="function.dns-get-mx.html"><LINK
REL="NEXT"
TITLE="fsockopen"
HREF="function.fsockopen.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=ISO-8859-1"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.dns-get-mx.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.fsockopen.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.dns-get-record"
></A
>dns_get_record</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN60389"
></A
><P
> (PHP 5 CVS only)</P
>dns_get_record --
Fetch DNS Resource Records associated with a hostname
</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN60392"
></A
><H2
>Description</H2
>array <B
CLASS="methodname"
>dns_get_record</B
> ( string hostname [, int type [, array &authns, array &addtl]])<BR
></BR
><P
> <DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Note: </B
>
This function is not implemented on Windows platforms. Try the
<A
HREF="http://pear.php.net/"
TARGET="_top"
>PEAR</A
> class
<A
HREF="http://pear.php.net/Net_DNS"
TARGET="_top"
>Net_DNS</A
>.
</P
></BLOCKQUOTE
></DIV
>
</P
><P
> This function returns an array of associative arrays. Each associative array contains
<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>at minimum</I
></SPAN
> the following keys:
<DIV
CLASS="table"
><A
NAME="AEN60416"
></A
><P
><B
>Table 1. Basic DNS attributes</B
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
ALIGN="LEFT"
VALIGN="MIDDLE"
>Attribute</TH
><TH
ALIGN="LEFT"
VALIGN="MIDDLE"
>Meaning</TH
></TR
></THEAD
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>host</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> The record in the DNS namespace to which the rest of the associated data refers.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>class</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <B
CLASS="function"
>dns_get_record()</B
> only returns Internet class records and as
such this parameter will always return <TT
CLASS="literal"
>IN</TT
>.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>type</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> String containing the record type. Additional attributes will also be contained
in the resulting array dependant on the value of type. See table below.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>ttl</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> Time To Live remaining for this record. This will <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>not</I
></SPAN
> equal
the record's original ttl, but will rather equal the original ttl minus whatever
length of time has passed since the authoritative name server was queried.
</TD
></TR
></TBODY
></TABLE
></DIV
>
</P
><P
> <TT
CLASS="parameter"
><I
>hostname</I
></TT
> should be a valid DNS hostname such
as "www.example.com". Reverse lookups can be generated using in-addr.arpa
notation, but <A
HREF="function.gethostbyaddr.html"
><B
CLASS="function"
>gethostbyaddr()</B
></A
> is more suitable for
the majority of reverse lookups.
</P
><P
> By default, <B
CLASS="function"
>dns_get_record()</B
> will search for any resource
records associated with <TT
CLASS="parameter"
><I
>hostname</I
></TT
>. To limit the
query, specify the optional <TT
CLASS="parameter"
><I
>type</I
></TT
> parameter.
<TT
CLASS="parameter"
><I
>type</I
></TT
> may be any one of the following:
<TT
CLASS="constant"
><B
>DNS_A</B
></TT
>, <TT
CLASS="constant"
><B
>DNS_CNAME</B
></TT
>,
<TT
CLASS="constant"
><B
>DNS_HINFO</B
></TT
>, <TT
CLASS="constant"
><B
>DNS_MX</B
></TT
>,
<TT
CLASS="constant"
><B
>DNS_NS</B
></TT
>, <TT
CLASS="constant"
><B
>DNS_PTR</B
></TT
>,
<TT
CLASS="constant"
><B
>DNS_SOA</B
></TT
>, <TT
CLASS="constant"
><B
>DNS_TXT</B
></TT
>,
<TT
CLASS="constant"
><B
>DNS_AAAA</B
></TT
>,
<TT
CLASS="constant"
><B
>DNS_ALL</B
></TT
> or <TT
CLASS="constant"
><B
>DNS_ANY</B
></TT
>.
The default is <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>DNS_ANY</I
></SPAN
>.
<DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Note: </B
>
Because of excentricities in the performance of libresolv
between platforms, <TT
CLASS="constant"
><B
>DNS_ANY</B
></TT
> will not
always return every record, the slower <TT
CLASS="constant"
><B
>DNS_ALL</B
></TT
>
will collect all records more reliably.
</P
></BLOCKQUOTE
></DIV
>
</P
><P
> The optional third and fourth arguments to this function,
<TT
CLASS="parameter"
><I
>authns</I
></TT
> and <TT
CLASS="parameter"
><I
>addtl</I
></TT
>
are passed by reference and, if given, will be populated with
Resource Records for the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Authoritative Name Servers</I
></SPAN
>,
and any <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Additional Records</I
></SPAN
> respectively.
See the example below.
</P
><P
> <DIV
CLASS="table"
><A
NAME="AEN60469"
></A
><P
><B
>Table 2. Other keys in associative arrays dependant on 'type'</B
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
ALIGN="LEFT"
VALIGN="MIDDLE"
>Type</TH
><TH
ALIGN="LEFT"
VALIGN="MIDDLE"
>Extra Columns</TH
></TR
></THEAD
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>A</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <TT
CLASS="literal"
>ip</TT
>: An IPv4 addresses in dotted decimal notation.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>MX</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <TT
CLASS="literal"
>pri</TT
>: Priority of mail exchanger.
Lower numbers indicate greater priority.
<TT
CLASS="literal"
>target</TT
>: FQDN of the mail exchanger.
See also <A
HREF="function.dns-get-mx.html"
><B
CLASS="function"
>dns_get_mx()</B
></A
>.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>CNAME</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <TT
CLASS="literal"
>target</TT
>: FQDN of location in DNS namespace to which
the record is aliased.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>NS</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <TT
CLASS="literal"
>target</TT
>: FQDN of the name server which is authoritative
for this hostname.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>PTR</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <TT
CLASS="literal"
>target</TT
>: Location within the DNS namespace to which
this record points.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>TXT</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <TT
CLASS="literal"
>txt</TT
>: Arbitrary string data associated with this record.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>HINFO</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <TT
CLASS="literal"
>cpu</TT
>: IANA number designating the CPU of the machine
referenced by this record.
<TT
CLASS="literal"
>os</TT
>: IANA number designating the Operating System on
the machine referenced by this record.
See <A
HREF="http://www.ietf.org/rfc/rfc1010.txt"
TARGET="_top"
>RFC 1010</A
> for the meaning of these
values.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>SOA</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <TT
CLASS="literal"
>mname</TT
>: FQDN of the machine from which the resource
records orignated.
<TT
CLASS="literal"
>rname</TT
>: Email address of the administrative contain
for this domain.
<TT
CLASS="literal"
>serial</TT
>: Serial # of this revision of the requested
domain.
<TT
CLASS="literal"
>refresh</TT
>: Refresh interval (seconds) secondary name
servers should use when updating remote copies of this domain.
<TT
CLASS="literal"
>retry</TT
>: Length of time (seconds) to wait after a
failed refresh before making a second attempt.
<TT
CLASS="literal"
>expire</TT
>: Maximum length of time (seconds) a secondary
DNS server should retain remote copies of the zone data without a
successful refresh before discarding.
<TT
CLASS="literal"
>minimum-ttl</TT
>: Minimum length of time (seconds) a
client can continue to use a DNS resolution before it should request
a new resolution from the server. Can be overridden by individual
resource records.
</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
>AAAA</TD
><TD
ALIGN="LEFT"
VALIGN="MIDDLE"
> <TT
CLASS="literal"
>ipv6</TT
>: IPv6 address
</TD
></TR
></TBODY
></TABLE
></DIV
>
</P
><P
> <DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Note: </B
>
Per DNS standards, email addresses are given in user.host format (for
example: hostmaster.example.com as opposed to hostmaster@example.com),
be sure to check this value and modify if necessary before using it
with a functions such as <A
HREF="function.mail.html"
><B
CLASS="function"
>mail()</B
></A
>.
</P
></BLOCKQUOTE
></DIV
>
</P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN60527"
></A
><P
><B
>Example 1. Using <B
CLASS="function"
>dns_get_record()</B
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="php"
><?php
$result = dns_get_record("php.net");
print_r($result);
?>
/*
Produces ouput similar to the following:
----------------------------------------
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
)
)
*/</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
> Since it's very common to want the IP address of a mail server
once the MX record has been resolved, <B
CLASS="function"
>dns_get_record()</B
>
also returns an array in <TT
CLASS="parameter"
><I
>addtl</I
></TT
> which
contains associate records. <TT
CLASS="parameter"
><I
>authns</I
></TT
>
is returned as well conatining a list of authoritative name
servers.
</P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN60535"
></A
><P
><B
>Example 2. Using <B
CLASS="function"
>dns_get_record()</B
> and DNS_ANY</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="php"
><?php
/* Request "ANY" record for php.net,
and create $authns and $addtl arrays
containing list of name servers and
any additional records which go with
them */
$result = dns_get_record("php.net",DNS_ANY,$authns,$addtl);
print "Result = ";
print_r($result);
print "Auth NS = ";
print_r($authns);
print "Additional = ";
print_r($addtl);
?>
/*
Produces output similar to the following:
-----------------------------------------
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
)
)
*/</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
> See also
<A
HREF="function.dns-get-mx.html"
><B
CLASS="function"
>dns_get_mx()</B
></A
>, and
<A
HREF="function.dns-check-record.html"
><B
CLASS="function"
>dns_check_record()</B
></A
>
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.dns-get-mx.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.fsockopen.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>dns_get_mx</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.network.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>fsockopen</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
distrib
>
Mandriva
>
9.1
>
ppc
>
media
>
main
>
by-pkgid
>
0afeee9cca140e167a996902b9a677c5
>
files
>
454
