array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.socket-getpeername.php', 1 => 'socket_getpeername', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funciones de Socket', ), 'prev' => array ( 0 => 'function.socket-getopt.php', 1 => 'socket_getopt', ), 'next' => array ( 0 => 'function.socket-getsockname.php', 1 => 'socket_getsockname', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/sockets/functions/socket-getpeername.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
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
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
Un recurso socket válido creado con socket_create() o socket_accept().
address
Si el socket dado es de tipo AF_INET
o
AF_INET6
, socket_getpeername()
devolverá la dirección IP de los pares (remotos) 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, también el puerto asociado.
Si el socket dado es de tipo AF_UNIX
,
socket_getpeername() devolverá la ruta del sistema de archivos
Unix (p.ej. /var/run/daemon.sock
) en el
parámetro address
.
port
Si se da, contendrá el puerto asociado a
address
.
Devuelve true
en caso de éxito o false
en caso de error. socket_getpeername() puede también devolver
false
si el tipo de socket no es ni AF_INET
,
AF_INET6
, ni AF_UNIX
, en cuyo
caso no se actualiza el último código de error de socket.
Nota:
socket_getpeername() no debería usarse con sockets
AF_UNIX
creados con socket_accept(). Sólo los sockets creados con socket_connect() o un socket principal de servidor seguido de una llamada a socket_bind() devolverán valores con sentido.
Nota:
Para hacer que socket_getpeername() devuelva un valor con sentido, el socket sobre el que es aplicado debe ser, por supuesto, uno cuyo concepto de "par" tenga sentido.