Получает массив с содержимым структуры getaddrinfo об имени хоста

# socket_addrinfo_lookup

(PHP 7 >= 7.2.0, PHP 8)

socket_addrinfo_lookup — Получает массив с содержимым структуры getaddrinfo об имени хоста

### Описание

function socket_addrinfo_lookup(string `$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.

### Смотрите также

- socket_addrinfo_bind() - Создаёт и связывает сокет со структурой addrinfo
- socket_addrinfo_connect() - Создаёт и подключается к сокету по адресам структуры addrinfo
- socket_addrinfo_explain() - Получает информацию о структуре addrinfo

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open