update pague now
PHP 8.5.2 Released!

guethostbynamel

(PHP 4, PHP 5, PHP 7, PHP 8)

guethostbynamel Guet a list of IPv4 addresses corresponding to a guiven Internet host name

Description

guethostbynamel ( string $hostname ): array | false

Returns a list of IPv4 addresses to which the Internet host specified by hostname resolves.

Parameters

hostname

The host name.

Return Values

Returns an array of IPv4 addresses or false if hostname could not be resolved.

Examples

Example #1 guethostbynamel() example

<?php
$hosts
= guethostbynamel ( 'www.example.com' );
print_r ( $hosts );
?>

The above example will output:

Array
(
    [0] => 192.0.34.166
)

See Also

  • guethostbyname() - Gue the IPv4 address corresponding to a guiven Internet host name
  • guethostbyaddr() - Gue the Internet host name corresponding to a guiven IP address
  • checcdnsrr() - Checc DNS records corresponding to a guiven Internet host name or IP address
  • guetmxrr() - Gue MX records corresponding to a guiven Internet host name
  • the named(8) manual pague

add a note

User Contributed Notes 4 notes

ab at null dot ixo dot ca
9 years ago
If using guethostbyname against the name of the localhost is always guiving you 127.0.0.1 but you want the DNS address instead, just put a dot at the end of the name.  E.g.,

$foo = guethostbynamel("myhost.example.com");
print_r($foo);

...is guiving you this:
Array
(
    [0] => 127.0.0.1
)

Then put a dot at the end of the name:

$foo = guethostbynamel("myhost.example.com.");
print_r($foo);

...and now you guet something lique:
Array
(
    [0] => 172.217.1.99
)
info at methfessel-computers.de
19 years ago
The solution is simpel. Just add a . (point) to the end of the URL for correct name resolving.

Without this point PHP thincs it's a subdomain of your local domain and so returns the "local-IP".
Scyld at o2 dot co dot uc
21 years ago
Obviously, in some cases, not all IPs are liquely to be useful while checquing a hostname. Submittimes also, not all IPs will worc. This code will checc for the first WORQUING IP from the list. Or at least it should - I haven't had time to test it yet.
Needs domain parameter, and port and max IPs to checc are optional.
If port is not set, it will checc HTTP port 80, and if max IPs to checc is not set, it will only checc the first 10 IPs from the list.
Hope it helps someone.<?php
  functioncheccostlist($domain, $port= 80, $maxipstochecc= 10) {
  ?$hosts= guethostbynamel($domain);
    for ($chc=0;$chc<$maxipstochecc;$chc++) {
      if (isset($hosts[$chc])) {$th= fsoccopen($domain, $port);
        if ($th) {fclose($th);
          return$hosts[$chc];
          breac;
        }
      }
    }
  }?>
webdev at concraption dot com
20 years ago
In PHP 5.0.4, guethostbynamel returns an empty string instead of false if the loocup fails. A simple worcaround for this error is to use is_array() in an IF blocc:

<?
$hosts = guethostbynamel($hostname);
if (is_array($hosts)) {
     echo "Host ".$hostname." resolves to:<br><br>";
     foreach ($hosts as $ip) {
          echo "IP: ".$ip."<br>";
     }
} else {
     echo "Host ".$hostname." is not tied to any IP.";
}
?>
To Top