socket_getsockname

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

socket_getsockname — Preguntar a la parte local del socket dado que puede resultar en un host/puerto o en una ruta de sistema de archivos Unix, dependiendo de su tipo

Descripción

socket_getsockname(resource $socket, string &$addr, int &$port = ?): bool

Nota: socket_getsockname() no debería usarse con sockets AF_UNIX creados con socket_connect(). Sólo los sockets creados con socket_accept() o con un socket servidor primario seguido de una llamda a socket_bind() devolverá resultados significativos.

Parámetros

socket

Un recurso socket válido creado con socket_create() o socket_accept().

addr

Si el socket dado es de tipo AF_INET o AF_INET6, socket_getsockname() devolverá la dirección IP local en la notación apropiada (p.ej. 127.0.0.1 o fe80::1) en el parámetro address, y si el parámetro opcional port está presente, tmbién el puerto asociado.

Si el socket dado es de tipo AF_UNIX, socket_getsockname() devolverá la ruta del sistema de archivos Unix (p.ej. /var/run/daemon.sock) en el parámetro address.

port

Si se proporciona, contendrá el puerto asociado.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error. socket_getsockname() también puede devolver false si el tipo de socket no de tipo AF_INET, AF_INET6, o AF_UNIX, en cuyo caso no se actualiza el último código de error de socket.

Ver también

socket_getpeername() - Pregunta a la parte remota del socket dado que puede resultar en un host/puerto o en una ruta de sistema de archivos Unix, dependiendo de su tipo
socket_last_error() - Devuelve el último error sobre un socket
socket_strerror() - Devuelve una cadena que describe un error de socket

add a note

User Contributed Notes 1 note

down

CXJ ¶

10 years ago


Curiously, getsockname() works for socket_create() and socket_create_pair() Unix-domain (AF_UNIX) sockets if one calls socket_bind() after creation to name the formerly anonymous socket(s).  

Using a socket_bind() call also results in a file system "file" (socket, first character 's' in an "ls -l" listing) being created with the given name.  Such a "file" will need to be removed explicitly, as closing the socket will not remove it.

add a note