socket_getsockname

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_getsockname — Interroga el socket local

Descripción

Nota: socket_getsockname() no debe ser utilizada con los sockets AF_UNIX creados con socket_connect() . Solo los sockets tras una llamada a socket_bind() devolverán valores lógicos.

Parámetros

socket

Una instancia de Socket creada por socket_create() o socket_accept() .

address

Si el socket socket es de tipo AF_INET , o AF_INET6 , socket_getsockname() devolverá la dirección IP local, en notación numérica (e.g. 127.0.0.1 o fe80::1) en el parámetro address, y si el parámetro opcional port está presente, también devolverá el puerto de la comunicación establecida.

Si el socket socket es de tipo AF_UNIX , socket_getsockname() devolverá la ruta en el sistema de archivos (e.g. /var/run/daemon.sock) en el parámetro address.

port

Si se proporciona, este deberá ser el puerto asociado a la dirección.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error. socket_getsockname() también puede devolver false si el tipo del socket no es ni AF_INET , ni AF_INET6 , ni AF_UNIX , en cuyo caso el último código de error socket no es modificado.

Historial de cambios

Véase también

• socket_getpeername() - Interroga el otro extremo de la comunicación
• socket_last_error() - Lee el último error generado por un socket
• socket_strerror() - Devuelve un string describiendo un mensaje de error