socket_addrinfo_lookup

(PHP 7 >= 7.2.0, PHP 8)

socket_addrinfo_lookupGet array with contents of getaddrinfo about the given hostname

Description

socket_addrinfo_lookup(string $host, ?string $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

host

Hostname to search.

service

The 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.

hints

Hints 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 other socket_addrinfo functions. On failure, false is returned.

Changelog

Version Description
8.0.0 On success, this function returns a array of AddressInfo instances now; previously, an array of resources was returned.
8.0.0 service is nullable now.

See Also

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top