socket_getsockname
Note:
socket_getsockname should not be used with AF_UNIX sockets created with socket_connect. Only sockets created with socket_accept or a primary server socket following a call to socket_bind will return meaningful values.
Parameters
- socket
-
A Socket instance created with socket_create or socket_accept.
- address
-
If the given socket is of type AF_INET or AF_INET6, socket_getsockname will return the local IP address in appropriate notation (e.g. 127.0.0.1 or fe80::1) in the address parameter and, if the optional port parameter is present, also the associated port.
If the given socket is of type AF_UNIX, socket_getsockname will return the Unix filesystem path (e.g. /var/run/daemon.sock) in the address parameter.
- port
-
If provided, this will hold the associated port.
Return Values
Returns true on success or false on failure. socket_getsockname may also return false if the socket type is not any of AF_INET, AF_INET6, or AF_UNIX, in which case the last socket error code is not updated.
Changelog
| Version | Description |
| 8.0.0 | socket is a Socket instance now; previously, it was a resource. |