socket_getpeername
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_getpeername —
Pergunta ao lado remoto do socket dado qual deve ser o resultado em host/port
ou no endereço UNIX filesystem, dependendo deste tipo.
Descrição
socket_getpeername(resource $socket
, string $&addr
, int $&port
= ?): bool
AvisoEsta função é
EXPERIMENTAL. O comportamento desta função, seu nome e
documentação poderão mudar sem aviso prévio em futuras versões do PHP.
Use por sua conta e risco.
Se o socket dado é do tipo AF_INET
ou AF_INET6
, socket_getpeername()
irá retornar o peers (remote) IP address na notação apropriada
(ex.
127.0.0.1
ou fe80::1
) no parâmetro
address
e, se o parâmetro opcional
port
está presente, também o associa à porta.
Se o socket dado é do tipo AF_UNIX
,
socket_getpeername() irá retornar o endereço UNIX filesystem
(ex. /var/run/daemon.sock
) no parâmetro
address
.
Nota:
socket_getpeername() não deve ser usado com sockets
AF_UNIX
criados com socket_accept().
Somente sockets criados com socket_connect() ou um socket de servidor primário seguindo uma chamada para socket_bind() irá retornar valores significativos.
Retorna true
em caso de sucesso ou false
em caso de falha. socket_getpeername() deve também retornar
false
se o tipo de socket não é algum destes AF_INET
,
AF_INET6
, ou AF_UNIX
, no caso
o último código de erro do socket não é atualizado.
Veja também
socket_getsockname(),
socket_last_error() e
socket_strerror().