socket_getsockname

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

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