Перейти к содержимому

Функция PHP gethostbynamel(): Всё, что нужно знать

Как PHP-разработчик, вы можете столкнуться с необходимостью получить все IP-адреса, связанные с заданным именем хоста. Встроенная функция gethostbynamel() решает эту задачу, выполняя DNS-запрос и возвращая массив адресов.

Что такое функция gethostbynamel()?

Функция gethostbynamel() — это встроенная в PHP функция, которая возвращает все IP-адреса, связанные с указанным именем хоста. Она выполняет DNS-запрос и возвращает массив всех совпадающих IP-адресов.

Как использовать функцию gethostbynamel()

Использование функции gethostbynamel() довольно просто. Ниже приведён синтаксис:

PHP-синтаксис функции gethostbynamel()

php
gethostbynamel($hostname);

Функция принимает один параметр:

  • $hostname: Имя хоста, для которого необходимо получить все IP-адреса.

Возвращаемое значение

Возвращает массив IP-адресов при успехе или false в случае ошибки.

Ниже приведён пример использования функции gethostbynamel() для получения всех IP-адресов, связанных с именем хоста:

Как использовать функцию gethostbynamel()

php
<?php

$hostname = "example.com";
$ip_addresses = gethostbynamel($hostname);

if ($ip_addresses !== false) {
    foreach ($ip_addresses as $ip_address) {
        echo "IP address for host name $hostname is $ip_address\n";
    }
} else {
    echo "Failed to resolve host name: $hostname\n";
}

В этом примере мы получаем все IP-адреса, связанные с именем хоста "example.com". Функция выполняет DNS-запрос и возвращает массив IP-адресов. Затем мы перебираем массив и выводим каждый адрес. Если DNS-запрос завершается неудачей, скрипт корректно обрабатывает возвращаемое значение false, не вызывая предупреждений PHP.

Ожидаемый вывод

IP address for host name example.com is 93.184.216.34

Заключение

Функция gethostbynamel() — это полезный инструмент для получения всех IP-адресов, связанных с заданным именем хоста. Понимая её синтаксис, возвращаемые значения и правильную обработку ошибок, вы сможете безопасно интегрировать её в свои PHP-приложения. Надеемся, эта статья оказалась полезной и помогла вам лучше понять функцию gethostbynamel() в PHP.

Практика

Какова цель функции gethostbyname() в PHP?

Считаете ли это полезным?

Предпросмотр dual-run — сравните с маршрутами Symfony на продакшене.