socket_addrinfo_lookup
PHP function
Edit on GitHub ✎
(PHP 7 >= 7.2.0, PHP 8)
Get array with contents of getaddrinfo about the given hostname
Description
socket_addrinfo_lookup(string $host, string|null $service = null, array $hints = []): array|false
Lookup different ways we can connect to host. The returned array contains a set of AddressInfo instances that we can bind to using socket_addrinfo_bind().
Parameters
hostHostname to search.
serviceThe service to connect to. If service is a numeric string, it designates the port. Otherwise it designates a network service name, which is mapped to a port by the operating system.
hintsHints provide criteria for selecting addresses returned. You may specify the hints as defined by getaddrinfo.
Return Values
Returns an array of AddressInfo instances that can be used with the socket_addrinfo_*() family of functions. On failure, false is returned.
Changelog
| Version | Description |
|---|---|
| 8.5.0 | Now throws a TypeError if any value of the hints array cannot be cast to int, and may throw a ValueError if any of these values overflow. |
| 8.0.0 | On success, this function returns an array of AddressInfo instances now; previously, an array of resources was returned. |
| 8.0.0 | service is nullable now. |