(PHP 7 >= 7.2.0, PHP 8)
socket_addrinfo_lookup — Получает массив с содержимым структуры getaddrinfo об имени хоста
$host, ? string $service = null , array $hints = []): array |false
Функция ищет доступные способы подключения к хосту host.
Массив, который возвращает функция, содержит набор экземпляров класса AddressInfo ,
к которым можно привязаться функцией socket_addrinfo_bind() .
hostИмя хоста для поиска.
serviceСлужба для подключения. Служба обозначает порт, если значение — числовая строка. Иначе это имя сетевой службы, которое операционная система сопоставляет с портом.
hintsПодсказки устанавливают критерии выбора возвращаемых адресов. Разрешается указывать подсказки так, как определяет структура getaddrinfo.
Функция возвращает массив экземпляров AddressInfo ,
которые передают в функции семейства socket_addrinfo_*.
Функция возвращает false , если возникла ошибка.
| Версия | Описание |
|---|---|
| 8.5.0 |
Теперь выбрасывает исключение TypeError ,
если какое-либо значение массива hints нельзя
привести к целому числу, и может выбросить исключение
ValueError , если какое-либо из этих
значений переполняется.
|
| 8.0.0 | В случае успешного выполнения функция возвращает массив экземпляров AddressInfo ; раньше возвращался ресурс (resource ). |
| 8.0.0 |
Параметр service теперь принимает значение null.
|